Sri Lankan Passport OCR with Python SDK

Extracting Data from Sri Lankan Passports

Sri Lankan passports combine printed identity fields, dates and a machine-readable zone on a security-patterned page. Capture quality, glare and perspective can make manual entry or plain text OCR difficult to use in a repeatable backend workflow.

Passport Extraction with the Python SDK

The StructOCR passport endpoint returns normalized passport fields from a readable Base64-encoded image or PDF. Your application can use the result to pre-fill a form or send it to a review step without maintaining its own field-parsing rules.

Common Integration Scenarios

• Travel onboarding: Pre-fill passport details before the traveller confirms them.
• Customer records: Move visible identity and expiry information into an internal review workflow.
• Document intake: Return consistent JSON to a small-volume application or operations team.

Sri Lankan Passport OCR with Python SDK

The official Python SDK reads a supported local file and calls /v1/passport. Open the FastAPI tab for a server route using the same SDK method.

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

client = StructOCR(os.environ["STRUCTOCR_API_KEY"])
result = client.scan_passport("passport.jpg")

if result.get("success"):
    data = result["data"]
    print(data.get("document_number") or data.get("passport_number"))
    print(data.get("given_names"), data.get("surname"))
else:
    print(result.get("error"))

JSON Response Example

This sample shows the normalized fields returned for a readable Sri Lankan passport; unavailable fields can be null.

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "LKA",
    "nationality": "SRI LANKAN",
    "passport_number": "P1234567",
    "surname": "DOE",
    "given_names": "ALEX",
    "sex": "X",
    "date_of_birth": "1990-01-01",
    "place_of_birth": "COLOMBO",
    "date_of_issue": "2024-05-10",
    "date_of_expiry": "2034-05-09",
    "issuing_authority": "DEPARTMENT OF IMMIGRATION AND EMIGRATION"
  }
}