The Node.js SDK for Mission-Critical Passport OCR

Why Passport OCR is Difficult

Implementing reliable passport OCR is non-trivial. Open-source tools like Tesseract fail on low-quality scans due to image artifacts like glare, shadows, and inconsistent lighting. Passports are often photographed at an angle, requiring computationally expensive deskewing and rotation correction. The Machine Readable Zone (MRZ) itself follows the strict ICAO 9303 standard, which includes complex check digit validation logic. Maintaining custom RegEx patterns to parse this zone is brittle and fails to adapt to minor variations across jurisdictions. These challenges lead to high error rates, manual review queues, and significant engineering overhead.

Enterprise-Grade Extraction with StructOCR

StructOCR simplifies document processing by replacing complex pipelines with a single API call. Our service leverages pre-trained Deep Learning models optimized for identity documents, including a robust passport mrz ocr api. This API automatically handles image pre-processing such as perspective correction, denoising, and glare removal. Unlike traditional OCR solutions that return unstructured text, StructOCR provides standardized JSON output with validated fields conforming to the ICAO 9303 standard. This capability is crucial for applications managing international borders, as it eliminates manual parsing and validation, delivering production-ready data directly to your system.

Production Use Cases

• Digital Onboarding (KYC): Reduce drop-off rates by pre-filling user data from Passports in < 2 seconds.
• Fraud Prevention: Detect tampered fonts or mismatched MRZ checksums automatically.
• Global Compliance: Handle Passports from 200+ jurisdictions without custom rules.

Implementation: Node.js SDK

The official Node.js SDK simplifies passport extraction. It handles file upload and parses both MRZ and Visual Inspection Zone (VIZ) data fields automatically.

Prerequisite: npm install structocr

const StructOCR = require('structocr');

// 💰 Save 30%+ vs competitors. Get 20 free credits instantly:
// 👉 https://structocr.com/register
// Initialize the client with your API key
const client = new StructOCR('YOUR_API_KEY_HERE');

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

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

    // The SDK handles file reading and the API call
    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.given_names} ${data.surname}`);
      console.log(`Nation:     ${data.nationality} (${data.country_code})`);
      
      // Visual Zone Specifics (Unique to StructOCR)
      console.log(`Birth Place:${data.place_of_birth}`);
      console.log(`Issued At:  ${data.place_of_issue}`);
      
      // Dates
      console.log(`DOB:        ${data.date_of_birth} (${data.sex})`);
      console.log(`Expiry:     ${data.date_of_expiry}`);

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

scanPassport();

Sample JSON Output

StructOCR returns a normalized JSON object, regardless of the input image angle or quality.

{
  "success": true,
  "data": {
    "type": "passport",
    "country_code": "USA",
    "nationality": "UNITED STATES",
    "passport_number": "E12345678",
    "surname": "DOE",
    "given_names": "JOHN",
    "sex": "M",
    "date_of_birth": "1990-01-01",
    "place_of_birth": "NEW YORK, USA",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2030-01-01",
    "place_of_issue": "PASSPORT AGENCY"
  }
}