🚀 What's New in v1.4.0

• Receipt OCR: Extract merchant details, dates, total amounts, and tax information from shopping receipts.
• HIN OCR: Extract Hull Identification Numbers (HIN) from boats and marine vessels.
• Previous updates (v1.3.x): Added support for VIN, Shipping Containers, and Invoice OCR.
• Check out the Quick Start below to see how to use them!

The official Node.js client for StructOCR.

StructOCR allows developers to extract structured data from identity documents and industry codes with 99% accuracy. Integrate Passport OCR, National ID OCR, Driver License OCR, Invoice OCR, Receipt OCR, VIN OCR, HIN OCR, and Container OCR into your Node.js or Electron applications.

👉 Get your Free API Key here

Installation

Install via npm:

npm install structocr

Quick Start

1. Initialize the Client

const StructOCR = require('structocr');

// Initialize with your API Key
const client = new StructOCR('sk_live_xxxxxxxx');

2. Scan a Passport (Passport OCR)

Using async/await:

(async () => {
  try {
    const result = await client.scanPassport('./passport_sample.jpg');
    
    console.log('Document Number:', result.data.document_number);
    console.log('Full Name:', result.data.name);
    
  } catch (error) {
    console.error('OCR Failed:', error.message);
  }
})();

3. Scan Other Document Types

// Scan National ID
const idData = await client.scanNationalId('./id_card.png');

// Scan Driver License
const licenseData = await client.scanDriverLicense('./license.jpg');

// Scan Invoice
const invoiceData = await client.scanInvoice('./invoice.jpg');

// Scan Receipt (New in v1.4.0)
const receiptData = await client.scanReceipt('./receipt.jpg');

// Scan VIN
const vinData = await client.scanVin('./vin.jpg');

// Scan HIN (New in v1.4.0)
const hinData = await client.scanHin('./hin.jpg');

// Scan Container
const containerData = await client.scanContainer('./container.jpg');

Features

• Passport Parsing: Extract MRZ, Name, DOB, Expiry Date.
• ID Card OCR: Automatic field mapping for National IDs.
• Driver License: Extract vehicle class and license numbers.
• Invoice: Extract invoice number, currency, merchant, customer.
• Receipt: Extract merchant details, timestamps, and total amounts from thermal receipts.
• VIN OCR: Extract Vehicle Identification Number from car chassis or windshield.
• HIN OCR: Extract Hull Identification Numbers accurately from marine vessels.
• Container OCR: Extract shipping container numbers accurately from images.
• Base64 Handling: Automatically handles image encoding.

Documentation

For full API documentation, please visit StructOCR Docs.

License

MIT License.