Côte d'Ivoire CNI OCR Python SDK

Parsing CNI (Carte Nationale d'Identité) Challenges

Extracting data from the Côte d'Ivoire CNI presents specific challenges. First, the transition to the new biometric cards issued by ONECI means systems must handle modern polycarbonate layouts with complex security features and holograms that cause glare. Second, locating and accurately extracting the unique 11-digit NNI (Numéro National d'Identification) is critical for local compliance. Finally, manually parsing the Machine-Readable Zone (MRZ) on the back of the card to mathematically verify the document against identity fraud requires complex, error-prone regular expressions.

Why StructOCR for Côte d'Ivoire

StructOCR is specifically trained on a large dataset of modern Ivorian CNIs, ensuring superior accuracy with French typography and ONECI card layouts. Our Python SDK simplifies integration, automatically locating critical fields like the NNI. By abstracting away the complexities of image processing via our national ID parsing API, you can efficiently scale your KYC automation platform.

Common Use Cases in Francophone Africa

• Mobile Money Onboarding: Verify users for Mobile Money and Fintech apps in Côte d'Ivoire by pre-filling NNI data in < 2 seconds.
• Telecom Registration: Automate strict SIM card registration compliance with native French script extraction.
• Pan-ECOWAS Expansion: Seamlessly process users across West Africa. Our unified Python SDK automatically detects and extracts data from neighboring documents, such as the Senegal CNI or Mali NINA card, without requiring custom rules.

Python SDK Integration

Install the SDK via pip: `pip install structocr`. The SDK automatically maps Côte d'Ivoire-specific fields (like the NNI) and parses the TD1 MRZ block.

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

from structocr import StructOCR

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

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

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

        if result.get('success'):
            data = result['data']
            print("✅ Côte d'Ivoire CNI Extraction Successful!")
            
            # Basic Identity
            print(f"Region:      {data.get('country_code')}")
            print(f"Name:        {data.get('given_names')} {data.get('surname')}")
            print(f"Document No: {data.get('document_number')}")
            
            # Critical Local Field: NNI
            print(f"NNI Number:  {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_cote_divoire_id()

JSON Response Example

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

{
  "success": true,
  "data": {
    "type": "national_id",
    "country_code": "CIV",
    "nationality": "IVOIRIENNE",
    "document_number": "C0012345678",
    "card_series": "",
    "personal_number": "01234567890",
    "surname": "KOUASSI",
    "given_names": "YAO PASCAL",
    "sex": "M",
    "date_of_birth": "1990-05-15",
    "place_of_birth": "ABIDJAN",
    "address": "Cocody, Abidjan",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2030-01-01",
    "issuing_authority": "ONECI",
    "additional_fields": {
      "tramite_number": null,
      "mrz_line_1": "IDCIVC001234567<<<<<<<<<<<<<<<",
      "mrz_line_2": "9005156M3001018CIV<<<<<<<<<<<4",
      "mrz_line_3": "KOUASSI<<YAO<PASCAL<<<<<<<<<<<"
    }
  }
}