Hong Kong Driver License OCR API with Node.js

Reading the Hong Kong driving licence

The Transport Department licence is bilingual in Chinese and English and is tied to the holder’s HKID number. Typing these fields by hand slows down rental, onboarding, and fleet workflows and introduces formatting errors.

Structured Fields from One API Call

The Driver License OCR API returns the licence number, holder name, dates, issuing authority, address, and vehicle class when they are printed and legible; missing fields are null. Try a sample with the free driver license scanner. For coverage, pricing, and the full field list, see the driver license OCR API overview.

Common Integration Scenarios

• Vehicle rental: Pre-fill Hong Kong licence details before handover and keep the agent’s confirmation step.
• Driver onboarding: Move licence fields into a review queue without retyping the card.
• Fleet records: Track licence classes and expiry dates for internal compliance reminders.

Hong Kong Driver License OCR API with Node.js

The official Node.js SDK reads a local file and calls /v1/driver-license from your backend.

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");

const client = new StructOCR(process.env.STRUCTOCR_API_KEY);

async function main() {
  const result = await client.scanDriverLicense("driver-license.jpg");
  if (result.success) {
    const data = result.data;
    console.log(data.document_number);
    console.log(data.given_names, data.surname);
  } else {
    console.error(result.error);
  }
}

main().catch(console.error);

JSON Response Example

Fictional values showing the normalized shape; fields not present on the card are null.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "country_code": "HKG",
    "region": "Hong Kong",
    "personal_number": null,
    "surname": "CHAN",
    "given_names": "TAI MAN",
    "sex": null,
    "date_of_birth": "1990-04-12",
    "place_of_birth": null,
    "date_of_issue": "2023-05-02",
    "date_of_expiry": "2033-05-01",
    "date_of_first_issue": null,
    "issuing_authority": "TRANSPORT DEPARTMENT",
    "address": null,
    "vehicle_class": "1 2",
    "extra_details": {},
    "document_number": "A000000(0)"
  }
}