Portugal Passport OCR with the StructOCR Python SDK

Challenges with Portugal Passport Verification

Extracting accurate data from Portuguese passports presents unique challenges. The high-security features, embedded holograms, and potential for glare on the laminate can often obscure critical information, making manual entry or basic OCR solutions prone to errors. For reliable data capture, a specialized passport extraction api is essential to overcome these obstacles.

Why StructOCR for Portugal Passports

StructOCR offers unparalleled accuracy for Portuguese passport data extraction. Our advanced AI models are specifically trained to handle the nuances of these documents, minimizing errors even with challenging lighting conditions or complex backgrounds. You can integrate our powerful passport extraction api directly into your workflows, or leverage our comprehensive fintech identity verification software suite for end-to-end KYC processes. For the fastest Python integration, install the official StructOCR SDK and see the Python SDK documentation.

Built for High-Compliance Industries

• Travel & Aviation: Our system provides a crucial verification solution for travel, enabling faster passenger processing at check-in and boarding gates for Portuguese citizens. This significantly enhances the customer experience and operational efficiency.
• Financial Services: By utilizing our fintech identity verification software, financial institutions can automate the onboarding of new customers with Portuguese passports. This streamlines the KYC compliance process, reducing manual effort and accelerating account activation.

Portugal 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 StructOCR Client
client = StructOCR(os.environ["STRUCTOCR_API_KEY"])

def scan_portugal_passport():
    image_path = "portugal_passport_sample.jpg"

    try:
        print(f"Scanning {image_path}...")
        result = client.scan_passport(image_path)

        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"❌ Extraction Failed: {result.get('error')}")

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

if __name__ == "__main__":
    scan_portugal_passport()

JSON Response Example

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

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "PRT",
    "nationality": "PRT",
    "passport_number": "L123456",
    "surname": "FERREIRA",
    "given_names": "MARIA",
    "sex": "M",
    "date_of_birth": "1986-06-05",
    "place_of_birth": "LISBON",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2026-06-04",
    "issuing_authority": "IRN"
  }
}