Indian Passport Family Details OCR

import requests
import base64

# 📚 Developer Docs: https://structocr.com/developers/passport-ocr

# Note: StructOCR is strictly API-first. It natively supports File Uploads,
# Base64-encoded strings, and direct Image URLs without requiring an SDK.

with open("passport_family.jpg", "rb") as image_file:
    base64_image = base64.b64encode(image_file.read()).decode('utf-8')

url = "https://api.structocr.com/v1/passport/india/back-page"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "img": base64_image
}

try:
    # Processed in-memory at the edge with zero data retention
    print("Extracting Family Details...")
    response = requests.post(url, headers=headers, json=payload)
    result = response.json()

    if result.get('success'):
        print("✅ Family Details Extracted!\n")
        
        # Core identity context
        core = result['data']
        print(f"Applicant: {core.get('given_names')} {core.get('surname')}")
        
        # Deep family linkage from the back page
        family = core['country_specific']['last_page']
        print(f"Father:    {family.get('father_name')}")
        print(f"Mother:    {family.get('mother_name')}")
        print(f"Spouse:    {family.get('spouse_name', 'N/A')}")
    else:
        print(f"❌ Extraction Failed: {result.get('error')} - {result.get('message')}")
except Exception as e:
    print(f"Error: {e}")