Bulgaria Lichna karta (Лична карта) OCR Python SDK

Parsing Lichna karta (Лична карта) Challenges

Bulgarian Lichna karta presents unique OCR challenges. First, the mix of Cyrillic and Latin characters within the same document necessitates robust bilingual recognition that standard OCR engines struggle to provide. Second, locating and accurately extracting the 10-digit EGN (ЕГН - Uniform Civil Number) is critical for local compliance but formatting often varies. Finally, manually parsing the Machine-Readable Zone (MRZ) on the back of the card to mathematically verify the document's authenticity adds significant engineering overhead.

Why StructOCR for Bulgaria

StructOCR is specifically trained on a large dataset of Bulgarian Lichna karta, ensuring unparalleled accuracy with both Cyrillic and Latin scripts. Our Python SDK automatically locates critical fields like the EGN and simplifies integration via our national ID parsing API, making it ideal for accelerating your KYC automation platform.

Common Use Cases in the Balkans

• Digital Onboarding: Verify users for Fintech apps in Bulgaria by pre-filling EGN and Cyrillic name data in < 2 seconds.
• Telecom Registration: Automate SIM card registration with native Cyrillic script extraction.
• Pan-Balkan Expansion: Seamlessly process users across Eastern Europe. Our unified Python SDK automatically detects and extracts data from neighboring documents, such as the Romania ID or Greece ID, without requiring custom rules.

Python SDK Integration

Install the SDK via pip: `pip install structocr`. The SDK automatically maps Bulgaria-specific fields (like EGN) and parses the TD1 MRZ block.

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

from structocr import StructOCR

# 🔑 Need a key for Bulgaria? Get 200 free credits instantly:
# 👉 https://structocr.com/register
# Initialize with your API Key
client = StructOCR("YOUR_API_KEY_HERE")

def scan_bulgaria_id():
    # Note: Supports JPG, PNG, WebP (Max 4.5MB)
    image_path = "bulgaria_lichna_karta.jpg"

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

        if result.get('success'):
            data = result['data']
            print("✅ Bulgaria Lichna Karta 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 Local Field: EGN (ЕГН)
            print(f"EGN (ЕГН):   {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_bulgaria_id()

JSON Response Example

The SDK returns a Python dictionary containing the parsed visual data (VIZ) in Cyrillic, the EGN, and the raw Machine-Readable Zone (MRZ) block.

{
  "success": true,
  "data": {
    "type": "national_id",
    "country_code": "BGR",
    "nationality": "БЪЛГАРИЯ",
    "document_number": "640123456",
    "card_series": "",
    "personal_number": "9005151234",
    "surname": "ИВАНОВ",
    "given_names": "ДИМИТЪР",
    "sex": "M",
    "date_of_birth": "1990-05-15",
    "place_of_birth": "СОФИЯ",
    "address": "ж.к. Младост 1, бл. 10, вх. А, ап. 3, София",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2030-01-01",
    "issuing_authority": "МВР София",
    "additional_fields": {
      "tramite_number": null,
      "mrz_line_1": "IDBGR6401234560<<<<<<<<<<<<<<<",
      "mrz_line_2": "9005156M3001018BGR<<<<<<<<<<<4",
      "mrz_line_3": "IVANOV<<DIMITAR<<<<<<<<<<<<<<<"
    }
  }
}