India Passport OCR with the StructOCR Node.js SDK

Why Indian Passport OCR is Difficult in Node.js

Building a reliable passport OCR pipeline from scratch is non-trivial for Indian documents. The Indian passport features a complex bilingual layout, utilizing both Right-to-Left (RTL) Hindi script (Devanagari) and Left-to-Right (LTR) English text on the same data page. This bidirectional flow frequently causes errors in standard Node.js wrappers like Tesseract. Furthermore, the documents incorporate intricate security backgrounds and guilloche patterns that cause optical noise. Developing custom RegEx patterns in JavaScript to parse the Machine Readable Zone (MRZ) while correcting these multi-script alignment issues is highly brittle, often resulting in high manual review rates.

Enterprise-Grade Extraction with the StructOCR SDK

StructOCR simplifies document processing in your JavaScript ecosystem by replacing complex pipelines with a single async API call. Our service leverages pre-trained Deep Learning models optimized specifically for South Asian identity documents and the complexities of bidirectional Devanagari/English typography. Our passport mrz ocr api automatically handles perspective correction, denoising, and glare removal. Instead of returning raw, unstructured text strings, the StructOCR Node.js SDK provides standardized JSON output with validated fields. This capability is crucial for applications managing international borders, as it eliminates the need for manual parsing, delivering production-ready data directly to your Express, NestJS, or Next.js applications. For the fastest Node.js integration, install the official StructOCR SDK and see the Node.js SDK documentation.

Production Use Cases

• Digital Onboarding (e-KYC): Reduce drop-off rates by pre-filling user data from Indian Passports into your fintech or digital services apps in under 2 seconds.
• Travel & Aviation Apps: Seamlessly integrate with Node.js backends for automated check-in systems and border management at hubs like Indira Gandhi International Airport (DEL) in Delhi.
• Financial Compliance: Ensure strict compliance with the Reserve Bank of India (RBI) and regional Anti-Money Laundering (AML) regulations by automatically and accurately verifying identity documents.

India Passport OCR with the Node.js SDK

The official Node.js SDK handles file buffers, API communication, and structured passport results. Use the SDK directly or open the TypeScript + Express tab for a server endpoint. Keep your API key in STRUCTOCR_API_KEY.

Prerequisite: `npm install structocr`; set the server-side `STRUCTOCR_API_KEY` environment variable.

Prefer another stack? Open the Python SDK + FastAPI integration.

const StructOCR = require('structocr');

// Initialize the client with your API key
const apiKey = process.env.STRUCTOCR_API_KEY;
if (!apiKey) throw new Error('STRUCTOCR_API_KEY is not configured');
const client = new StructOCR(apiKey);

async function scanIndiaPassport() {
  // Note: Supports JPG, PNG, WebP, PDF (Max 4.5MB)
  const imagePath = './india_passport_sample.jpg';

  try {
    console.log(`Processing India passport: ${imagePath}...`);

    // The SDK handles file reading and the API call seamlessly
    const result = await client.scanPassport(imagePath);

    if (result.success && result.data) {
      const data = result.data;
      console.log('✅ Extraction Successful!');
      
      // Basic Identity (MRZ + VIZ)
      console.log(`Passport #: ${data.passport_number}`);
      console.log(`Name:       ${data.surname} ${data.given_names}`);
      console.log(`Nation:     ${data.nationality} (${data.country_code})`);
      
      // Visual Zone Specifics
      console.log(`Birth Place:${data.place_of_birth}`);
      console.log(`Authority:  ${data.issuing_authority}`);
      
      // Dates
      console.log(`DOB:        ${data.date_of_birth} (${data.sex})`);
      console.log(`Expiry:     ${data.date_of_expiry}`);

      // Country Specific (Indian Passport Last Page / Annexure)
      if (data.country_specific && data.country_specific.last_page) {
        const lastPage = data.country_specific.last_page;
        console.log(`Father:     ${lastPage.father_name}`);
        console.log(`Spouse:     ${lastPage.spouse_name}`);
        console.log(`Address:    ${lastPage.address}`);
      }

    } else {
      console.error('❌ Extraction Failed:', result.error || 'Unknown Error');
    }
  } catch (error) {
    console.error('An unexpected error occurred:', error.message);
  }
}

scanIndiaPassport();

Sample JSON Output

The Node.js SDK returns an object matching this normalized JSON structure.

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "IND",
    "nationality": "INDIAN",
    "passport_number": "Z1234567",
    "surname": "PATEL",
    "given_names": "RAJESH",
    "sex": "M",
    "date_of_birth": "1990-10-05",
    "place_of_birth": "MUMBAI",
    "date_of_issue": "2023-06-15",
    "date_of_expiry": "2028-06-14",
    "issuing_authority": "MINISTRY OF EXTERNAL AFFAIRS",
    "country_specific": {
      "last_page": {
        "father_name": "AMIT PATEL",
        "mother_name": "SITA PATEL",
        "spouse_name": "PRIYA PATEL",
        "address": "FLAT 4B, GREENWOOD APARTMENTS, NEW DELHI PIN: 110001, INDIA",
        "old_passport_number": "P7654321",
        "old_passport_issue_date": "2013-06-10",
        "old_passport_issue_place": "MUMBAI",
        "file_no": "B01076071103622",
        "ecr_status": null
      }
    }
  }
}