Hungary Személyazonosító OCR Python SDK

Parsing Személyazonosító Challenges

Hungarian Személyazonosító cards pose unique OCR challenges. First, the presence of specific native Hungarian characters and accents (such as ő, ű, á, é, í) requires highly robust native script recognition to prevent data corruption. Second, varying layouts across different card versions and print quality variations complicate data extraction. Finally, ensuring the document's authenticity requires reliably locating and strictly validating the Machine-Readable Zone (MRZ) on the back of the card, while correctly transliterating Hungarian visual text into the MRZ format.

Why StructOCR for Hungary

Our model is specifically trained on a large dataset of Hungarian Személyazonosító cards, including variations in layout and print quality, making it ideal for advanced id card parsing tasks. The Python SDK simplifies integration, effortlessly handling complex Hungarian typography. It automatically preprocesses images and actively parses the embedded TD1 MRZ, allowing developers to quickly and securely deploy KYC automation workflows with minimal code.

Common Use Cases in Hungary

• Digital Onboarding: Verify users for Fintech apps in Hungary by automatically matching VIZ data against the cryptographic MRZ.
• Telecom Registration: Automate SIM card registration with robust extraction of Hungarian addresses and special characters.
• Hotel Check-in: Speed up guest registration workflows with automated eSzemélyi MRZ scanning.

Python SDK Integration

Install the SDK via pip: `pip install structocr`. The SDK automatically maps Hungarian visual fields and extracts the raw TD1 MRZ lines.

Prerequisite: Python 3.6+ and `structocr` library installed.

from structocr import StructOCR

# Get 200 free credits:
# 👉 https://structocr.com/register
# Initialize with your API Key
client = StructOCR("YOUR_API_KEY_HERE")

def scan_hungary_id():
    # Note: Supports JPG, PNG, WebP (Max 4.5MB)
    # Target: Személyazonosító
    image_path = "hungary_national_id.jpg"

    try:
        print(f"Scanning {image_path}...")
        
        # The SDK handles file upload and API communication
        result = client.scan_national_id(image_path)

        if result.get('success'):
            data = result['data']
            print("✅ Hungary Extraction Successful!")
            
            # Basic Identity
            print(f"Region:      {data.get('country_code')}")
            print(f"Name:        {data.get('given_names')} {data.get('surname')}")
            print(f"ID Number:   {data.get('document_number')}")
            
            # Critical Field: Personal Identity Number
            print(f"Personal #:  {data.get('personal_number')}")
            
            # Demographics
            print(f"DOB:         {data.get('date_of_birth')} ({data.get('sex')})")
            print(f"Address:     {data.get('address')}")
            
            # Extract TD1 MRZ Data
            additional = data.get('additional_fields', {})
            if additional.get('mrz_line_1'):
                print("\n🔍 MRZ Data Extracted & Validated:")
                print(f"Line 1: {additional.get('mrz_line_1')}")
                print(f"Line 2: {additional.get('mrz_line_2')}")
                print(f"Line 3: {additional.get('mrz_line_3')}")
        else:
            print(f"❌ Extraction Failed: {result.get('error')}")

    except Exception as e:
        print(f"An error occurred: {e}")

if __name__ == "__main__":
    scan_hungary_id()

JSON Response Example

The SDK returns a Python dictionary matching this JSON structure, including the parsed visual data with native Hungarian characters and the raw Machine-Readable Zone (MRZ).

{
  "success": true,
  "data": {
    "type": "national_id",
    "country_code": "HUN",
    "nationality": "MAGYAR",
    "document_number": "123456AB",
    "card_series": "",
    "personal_number": "1 900101 1234",
    "surname": "NAGY",
    "given_names": "ISTVÁN",
    "sex": "M",
    "date_of_birth": "1990-05-15",
    "place_of_birth": "BUDAPEST",
    "address": "1052 Budapest, Deák Ferenc tér 1.",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2030-01-01",
    "issuing_authority": "Budapest Főváros Kormányhivatala",
    "additional_fields": {
      "tramite_number": null,
      "mrz_line_1": "IDHUN123456AB<9<<<<<<<<<<<<<<<",
      "mrz_line_2": "9005156M3001018HUN<<<<<<<<<<<4",
      "mrz_line_3": "NAGY<<ISTVAN<<<<<<<<<<<<<<<<<<"
    }
  }
}