Spain Passport OCR with the StructOCR Python SDK

Challenges with Spain Passport Verification

Extracting accurate data from Spanish passports can be a complex task. Security features, intricate background patterns, and laminate glare often obscure critical information. Manual entry is prone to errors and delays. Our core passport data extraction api is specifically engineered to overcome these optical obstacles, ensuring high accuracy without relying on heavy client-side processing.

Why Use Our Passport Extraction API

Our engine excels in processing Spanish identity documents with unparalleled accuracy. Delivered as a pure REST API deployed on a global edge network, it integrates seamlessly into your existing stack regardless of the framework. Whether you are building a fintech identity verification software solution or a travel booking platform, our passport extraction API handles raw PDFs, image files, Base64 strings, or direct URLs to provide reliable, structured JSON results instantly. For the fastest Python integration, install the official StructOCR SDK and see the Python SDK documentation.

Built for High-Compliance Industries

• Travel & Aviation: Our technology provides a seamless verification solution for travel, significantly speeding up check-in by using the API to validate Spanish passport details in under a second.
• Financial Services: Leverage our robust fintech identity verification software to automate KYC onboarding, utilizing direct Base64 uploads to maintain strict data compliance.

Spain Passport OCR with the Python SDK

The official Python SDK handles file encoding, API communication, and structured passport results. Use the SDK directly or open the FastAPI tab for a server endpoint. Keep your API key in STRUCTOCR_API_KEY.

Prerequisite: `pip install structocr`; set the server-side `STRUCTOCR_API_KEY` environment variable.

Prefer another stack? Open the Node.js SDK + Express integration.

import os
from structocr import StructOCR

# Initialize API Client for Edge Processing
client = StructOCR(os.environ["STRUCTOCR_API_KEY"])

def extract_spain_passport():
    # Supports local files (PDF/Images), Base64 encoded strings, or URLs
    document_source = "spain_passport_sample.pdf"

    try:
        print(f"Executing passport data extraction API for {document_source}...")
        result = client.scan_passport(document_source)

        if result.get('success'):
            data = result['data']
            print("✅ Passport Extraction Successful!")
            print(f"Passport #:  {data.get('passport_number')}")
            print(f"Name:        {data.get('given_names')} {data.get('surname')}")
            print(f"Nationality: {data.get('nationality')}")
            print(f"DOB:         {data.get('date_of_birth')}")
        else:
            print(f"❌ API Extraction Failed: {result.get('error')}")

    except Exception as e:
        print(f"Error: {e}")

if __name__ == "__main__":
    extract_spain_passport()

JSON API Response Example

The Python SDK returns a dictionary matching this normalized JSON structure.

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "ESP",
    "nationality": "ESP",
    "passport_number": "PA123456",
    "surname": "GARCÍA",
    "given_names": "ANTONIO",
    "sex": "M",
    "date_of_birth": "1975-01-20",
    "place_of_birth": "MADRID",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2025-01-19",
    "issuing_authority": "DGP"
  }
}