Hong Kong HKID OCR API with Node.js

Working with the Hong Kong Identity Card (HKID)

The smart HKID shows the holder’s name in English and Chinese, the HKID number with its check character in brackets, and date of birth. Re-keying these values is slow, and generic OCR still leaves your team to map each text fragment to the right field.

Structured Extraction for Your Backend

The National ID OCR API returns the HKID number, names, dates, and address when they are printed on the submitted side of the card. Test it with the free ID card scanner.

Common Integration Scenarios

• Customer onboarding: Pre-fill identity fields from the Hong Kong Identity Card (HKID) before the customer confirms them.
• Account operations: Reduce manual transcription when staff enter identity data.
• Document review: Store normalized output next to your own review decision.

Hong Kong HKID OCR API with Node.js

The official Node.js SDK reads a local file and calls /v1/national-id 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.scanNationalId("id-card.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 for a readable Hong Kong Identity Card (HKID); unavailable fields are null.

{
  "success": true,
  "data": {
    "type": "national_id",
    "country_code": "HKG",
    "document_number": "A000000(0)",
    "personal_number": null,
    "surname": "DOE",
    "given_names": "ALEX",
    "sex": null,
    "date_of_birth": "1990-01-01",
    "place_of_birth": null,
    "date_of_issue": null,
    "date_of_expiry": null,
    "issuing_authority": null,
    "address": null,
    "additional_fields": {}
  }
}