Honduras DNI OCR API with Node.js
Extract the DNI number, names, and dates from the Honduras Documento Nacional de Identificación (DNI) with the StructOCR Node.js SDK and a server-side integration.
Working with the Documento Nacional de Identificación (DNI)
The Honduran DNI uses a 13-digit number printed in groups of four, four, and five digits. 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 DNI 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 Documento Nacional de Identificación (DNI) 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.
Honduras DNI 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);Technical Specs
- •Endpoint: POST /v1/national-id
- •Input: Base64-encoded JPG, PNG, WebP, or PDF in JSON (Max 4.5MB)
- •Authentication: Server-side x-api-key header handled by the SDK
- •Cost: 2 credits per successful scan; failed requests are not billed
- •Output: Structured JSON
Key Features
- •Local document: Handles the Documento Nacional de Identificación (DNI) as a national identity document.
- •Identifier output: Returns the DNI number when visible.
- •Normalized names and dates: Consistent JSON keys across countries.
- •Server integration: The API key stays on your backend.
JSON Response Example
Fictional values showing the normalized shape for a readable Documento Nacional de Identificación (DNI); unavailable fields are null.
{
"success": true,
"data": {
"type": "national_id",
"country_code": "HND",
"document_number": "0801-1990-00000",
"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": "TEGUCIGALPA",
"additional_fields": {}
}
}Frequently Asked Questions
Does the API validate the DNI number?
It extracts the number as printed. Database checks and authenticity verification require official channels or your own review.
Which inputs are supported?
JSON with a Base64-encoded JPG, PNG, WebP, or PDF up to 4.5MB; the SDK handles encoding.
Is there a version for the other SDK language?
Yes. A paired Python version of this tutorial covers the same document.
You May Also Like
Related tutorials, platform guides, and comparisons
Honduras DNI OCR API with Python
Extract the DNI number, names, and dates from the Honduras Documento Nacional de Identificación (DNI) with the StructOCR Python SDK and a server-side integration.
Cameroon CNI OCR API with Node.js
Extract the CNI number, names, and dates from the Cameroon Carte Nationale d’Identité (CNI) with the StructOCR Node.js SDK and a server-side integration.
UAE Emirates ID OCR with Node.js SDK
Extract Emirates ID number, names, dates and other visible fields from Emirates ID with the StructOCR Node.js SDK and Express.
Philippines PhilID OCR with Node.js SDK
Extract PhilSys Card Number, names, dates and other visible fields from Philippine Identification Card (PhilID) with the StructOCR Node.js SDK and Express.
India Aadhaar OCR with Node.js SDK
Extract Aadhaar number, names, dates and other visible fields from Aadhaar card with the StructOCR Node.js SDK and Express.
Pakistan CNIC OCR with Node.js SDK
Extract CNIC number, names, dates and other visible fields from Computerized National Identity Card (CNIC) with the StructOCR Node.js SDK and Express.
Dominican Republic Cédula OCR API with Node.js
Extract the cédula number, names, and dates from the Dominican Republic Cédula de Identidad y Electoral with the StructOCR Node.js SDK and a server-side integration.
Tunisia CIN (Carte d'Identité Nationale) OCR Python SDK
Python Tutorial: Automate KYC in Tunisia. Extract data from CIN (Carte d'Identité Nationale) using StructOCR Python SDK. Supports native text.
Ukraine National ID OCR Python SDK
Python Tutorial: Automate KYC in Ukraine. Extract data from National ID using StructOCR Python SDK. Supports native text and MRZ extraction.
Uganda National ID Card OCR Python SDK
Python Tutorial: Automate KYC in Uganda. Extract data from National ID Card using StructOCR Python SDK. Supports native text and MRZ extraction.
Technical Comparisons & Integrations
Explore platform integrations and competitive analysis
Add National ID OCR to Your Bolt.new App in 5 Minutes
Step-by-step guide to integrating the StructOCR National ID scanner API into a Bolt.new app. Build KYC and identity verification flows right in your browser.
Add National ID OCR using Cursor in 5 Minutes
Step-by-step guide to integrating the StructOCR National ID scanner API using the Cursor AI code editor. Build KYC and identity verification flows rapidly.
Add National ID OCR to Your Lovable.dev App in 5 Minutes
Step-by-step guide to integrating the StructOCR National ID scanner API into a Lovable.dev app. Build KYC and identity verification flows with zero backend.
Add National ID OCR to Your Replit App in 5 Minutes
Step-by-step guide to integrating the StructOCR National ID scanner API into a Replit application. Build KYC and identity verification flows using Replit Agent and Secrets.
Add National ID OCR to Your v0 App in 5 Minutes
Step-by-step guide to integrating the StructOCR National ID scanner API into a v0 by Vercel app. Build KYC and identity verification flows with zero backend.
Google Cloud Vision vs. StructOCR API for Shipping Containers
Comparing generic enterprise OCR solutions like Google Cloud Vision against StructOCR's purpose-built API for ISO 6346 shipping container recognition.
From tutorial to production in 5 minutes.
You've seen the code. Now get your API key, grab your 200 free credits, and see it work with your own images. No credit card required.