Brazil Driver License OCR with Node.js SDK

Reading Brazil Driver Licenses

The CNH includes Brazilian identity references, licence category and first-licence information in a dense card layout. Manual transcription adds delays and creates avoidable formatting errors when a team needs to move licence data into onboarding, rental or mobility systems.

A Server-Side Node.js SDK Workflow

The StructOCR driver license endpoint accepts a Base64-encoded image or PDF and returns normalized fields that are visible on the document. Typical results include the document number, holder name, dates, issuing region, address and vehicle class; optional fields may be null when they are absent or unreadable.

Common Integration Scenarios

• Vehicle rental: Pre-fill customer and licence details before a vehicle handover.
• Driver onboarding: Move visible licence fields into a review queue without retyping the card.
• Fleet operations: Capture licence classes and validity dates for internal driver records.

Brazil Driver License OCR with Node.js SDK

The official Node.js SDK reads a supported local file and calls /v1/driver-license. Open the TypeScript + Express tab for a server route using the same SDK method.

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

Fields are returned when present and legible on the submitted licence; country-specific details may appear in extra_details.

{
  "success": true,
  "data": {
    "type": "drivers_license",
    "country_code": "BRA",
    "region": "São Paulo",
    "document_number": "01234567890",
    "personal_number": "123.456.789-00",
    "surname": "SILVA",
    "given_names": "ANA PAULA",
    "sex": "F",
    "date_of_birth": "1991-03-12",
    "place_of_birth": "CAMPINAS SP",
    "date_of_issue": "2024-05-20",
    "date_of_expiry": "2034-05-20",
    "date_of_first_issue": "2010-07-15",
    "issuing_authority": "DETRAN SP",
    "address": null,
    "vehicle_class": "AB",
    "extra_details": {
      "fathers_name": "CARLOS SILVA",
      "mothers_name": "LUCIA SILVA",
      "rg_number": "12.345.678-9"
    }
  }
}