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 replaces this entire complex pipeline with a single API call. Our service is powered by pre-trained Deep Learning models specifically optimized for identity documents. The API performs automatic image pre-processing, including perspective correction, denoising, and glare removal, before extraction even begins. Unlike Tesseract which returns unstructured text, StructOCR provides a standardized JSON output with validated fields conforming to the ICAO 9303 standard. This eliminates manual parsing and validation, delivering production-ready data directly to your application.

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 200 free requests 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"
  }
}