Photographed Thai National ID Card With Signature Detection

Reads a photographed or photocopied Thai national ID card, in colour or black and white, and returns its number, names, dates and address with a confidence per field, and whether the copy is signed.

POST/v3/store/ekyc/thai-national-id-card-with-signatureTry it

• Price1.25 ICper page
• Measured97.1%
• Capacity10,500 cards/hour
• Served49.6Kcalls

• v1.1.1-20260822
• Updated 22 Aug 2026
• Active
• Benchmark paper (PDF)

Input

OutputPOST /v3/store/ekyc/thai-national-id-card-with-signature

national_id

3411700830334

fullname_th

นาง บุญยัง โลเปช

fullname_en

Mrs. Bunyang Lopez

date_of_birth

22 มี.ค. 2500

address_full

33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี

reason_code_id_card_signature

1

process_time

0.7

Every field, under Response

Request

curl -X POST https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card-with-signature \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@idcard.jpg"

Response

200OK. The fields are explained under Response.

{
    "national_id": "3411700830334",
    "fullname_th": "นาง บุญยัง โลเปช",
    "fullname_en": "Mrs. Bunyang Lopez",
    "date_of_birth": "22 มี.ค. 2500",
    "address_full": "33/349 หมู่ที่ 7 ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "reason_code_id_card_signature": 1,
    "process_time": 0.7
}

Request

multipart/form-data, one card per request. For a photograph of the physical card itself, use Thai National ID Card OCR.

Headers

apikeystringrequired

Your API key, created under API Keys in the control panel.

Body

filefilerequired

The front of the card, as photographed or copied. JPEG, PNG, HEIC or HEIF, up to 2 MB; the card at least 600 × 400 px in the image.

The legacy paths /thai-national-id-card-with-signature/front and /thai-national-id-card/copy answer at the same price.

Response

national_idstring

The 13-digit number

init_thinit_enname_thname_ensurname_thsurname_enfullname_thfullname_en

Title, given name, surname and full name, in Thai and in English

date_of_birthdate_of_expire

Thai format, as printed

address_fulladdress_numberaddress_subdistrictaddress_districtaddress_provinceaddress_postal_code

The address as printed and its parts; the postal code is derived

reason_code_id_cardreason_code_id_card_national_idreason_code_id_card_signature

1 when a card, the number and a signature were found, 0 otherwise

confidence

0 to 1 per field: national_id, fullname_th, date_of_birth, address_full

process_timerequest_idfile_name_id_cardreason_code_api

Seconds, the gateway's request id, the file name, the status code

Status codes

Code	Meaning
200	Success
413	The file is over 2 MB
414	No file attached
415, 422	The image's dimensions are outside the limits
420	No ID card found in the image
421	Unsupported or corrupted image
427, 428	Processing or queue timeout
560	The server is busy; retry
563	The image could not be processed

Details

Measured

Against human-verified ground truth: 33 real cards, 594 field observations. The set is private.

Measure	Result
National ID number	100%
House number	97.0%
Full address	93.9%
All fields	97.1%
Signature detection	96.5%
Median time	0.7 s per card
Sustained throughput	10,500 cards per hour, production, August 2026

Method, per-field results and a comparison with a leading cloud OCR service: the benchmark paper (PDF).

Limits

• Scans at 300 dpi or higher give the best results.
• A blurred card, or one that fills a small part of the frame, reads worse.

Data handling

Images are processed in memory and not kept after the response. The service is GDPR and PDPA compliant. For an on-premise deployment, in which no card leaves your network, contact us.

Changelog

Version	Date	Changes
v1.1.1-20260822	22 Aug 2026	New engine: field-level accuracy 96.3% to 97.1%, largest gains on house numbers and addresses; on-premise deployment.
v1.0	2023	First release, with signature detection.