Brazil CIN OCR Python SDK

Parsing Carteira de Identidade (CIN) Challenges

Identity verification in Brazil is undergoing a massive transition. Organizations must process both the legacy RG (Registro Geral)—which has 27 different layout variations across states—and the newly unified Carteira de Identidade Nacional (CIN). Standard OCR engines struggle with this high variance, frequently misreading critical numbers or failing on complex Portuguese layouts. Furthermore, the new CIN introduces a Machine-Readable Zone (MRZ) on the reverse side, requiring advanced mathematical parsing to verify the document's authenticity against identity fraud.

Why StructOCR for Brazil

StructOCR is explicitly trained to bridge this transition. Our models gracefully handle both legacy RG layouts and the new, unified CIN standard, enabling unparalleled accuracy. Our Python SDK automatically locates the CPF (Cadastro de Pessoas Físicas)—now the single identifier for Brazilians—extracting it seamlessly via our national ID parsing API to power your KYC automation platform.

Common Use Cases in Latin America

• Digital Onboarding & PIX: Verify users for Fintech apps and PIX payments in Brazil by pre-filling CIN and CPF data in < 2 seconds.
• Telecom Registration: Automate robust SIM card registration by natively extracting the unified CPF number.
• Pan-LatAm Expansion: Seamlessly process users across Mercosur. Our unified Python SDK automatically detects and extracts data from neighboring documents, such as the Argentina DNI or Chile RUN, without requiring any custom rules.

Python SDK Integration

Install the SDK via pip: `pip install structocr`. The SDK automatically maps Brazil-specific fields (like CPF) and parses the TD1 MRZ block found on the new CIN.

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

from structocr import StructOCR

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

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

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

        if result.get('success'):
            data = result['data']
            print("✅ Brazil CIN Extraction Successful!")
            
            # Basic Identity
            print(f"Region:      {data.get('country_code')}")
            print(f"Name:        {data.get('given_names')} {data.get('surname')}")
            
            # Critical Local Field: Unified CPF
            print(f"CPF:         {data.get('personal_number')}")
            
            # Demographics
            print(f"DOB:         {data.get('date_of_birth')} ({data.get('sex')})")
            print(f"Address:     {data.get('address', 'Extracted from back')}")
            
            # Extract TD1 MRZ Data (New CIN)
            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_brazil_id()

JSON Response Example

The SDK returns a Python dictionary containing the parsed visual data (VIZ), the Brazilian CPF, and the raw Machine-Readable Zone (MRZ) block found on the back of the CIN.

{
  "success": true,
  "data": {
    "type": "national_id",
    "country_code": "BRA",
    "nationality": "BRASILEIRA",
    "document_number": "12345678900",
    "card_series": "",
    "personal_number": "123.456.789-00",
    "surname": "DA SILVA",
    "given_names": "JOÃO PEDRO",
    "sex": "M",
    "date_of_birth": "1990-05-15",
    "place_of_birth": "SÃO PAULO - SP",
    "address": "AV PAULISTA 1000, SÃO PAULO - SP",
    "date_of_issue": "2023-11-20",
    "date_of_expiry": "2033-11-20",
    "issuing_authority": "GOVERNO FEDERAL",
    "additional_fields": {
      "tramite_number": null,
      "mrz_line_1": "IDBRA1234567890<<<<<<<<<<<<<<<",
      "mrz_line_2": "9005156M3311208BRA<<<<<<<<<<<4",
      "mrz_line_3": "DA<SILVA<<JOAO<PEDRO<<<<<<<<<<"
    }
  }
}