Skip to main content

🪪 Thai National ID Card OCR

1.25 ICper request (front)|0.75 ICper request (back)
v3.5 Active Nov 2022 POST /v3/store/ekyc/thai-national-id-card

Welcome to Thai National ID Card OCR API, version 3.5, an AI product developed by iApp Technology Co., Ltd. Our API is designed to extract text information from both the front and back face of Thai National ID card images with high accuracy and speed. Our API supports JPEG, JPG, PNG, HEIC, HEIF, and PDF file formats and can process an ID card image in 1-2 seconds.

Try Demo​

Try Our AI Demo

Login or create a free account to use this AI service demo and explore our powerful APIs.

Get 100 Free Credits (IC) when you sign up!

Offer ends December 31, 2025

Create Free AccountLogin

Example Images (Click to try)

Example 1
Try Demo

Log in to use your API keys or Create an account



Getting Started​


    

  1. 

    Prerequisites
    

      

    • An API key from iApp Technology
      • 

    • Thai national ID card images (front/back)
      • 

    • Supported file formats: JPEG, JPG, PNG, HEIC, HEIF, PDF
      • 

    • Maximum file size: 10MB
      • 

    

    2. 

  2. 

    Quick Start
    

      

    • Fast processing (1-2 seconds per card)
      • 

    • High accuracy text extraction (98.13% at character level)
      • 

    • Support for multiple file formats
      • 

    

    3. 

  3. 

    Key Features
    

      

    • Detailed field extraction including:

        

      • ID number
        • 

      • Full name (Thai and English)
        • 

      • Date of birth
        • 

      • Religion
        • 

      • Address
        • 

      • Issue and expiry dates
        • 

      

      • 

    • Support for both front and back of ID cards
      • 

    • Option to return original OCR text and processed images
      • 

    • Flexible JSON response format
      • 

    

    4. 

  4. 

    Security & Compliance
    

      

    • GDPR and PDPA compliant
      • 

    • No data retention after processing
      • 

    

    5. 



How to get API Key?
Please visit API Key Management page to view your existing API key or request a new one.


Example​


Front side​

Thai National ID Card Example (Front side)

Request:​


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


Response:​


{
    "address": "XXXXXX XXXX X ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
    "alley": "",
    "detection_score": 0.981011797984441,
    "district": "บางละมุง",
    "en_dob": "XX Mar 1957",
    "en_expire": "XX Mar 2025",
    "en_fname": "XXXXXX",
    "en_init": "Mrs.",
    "en_issue": "26 Jul 2016",
    "en_lname": "Lopez",
    "en_name": "Mrs. XXXXXX Lopez",
    "error_message": "",
    "face": "/9j/4AAQ...UAFFFFAH/9k=", # Base64 of photo's image
    "gender": "Female",
    "home_address": "XXXXX XXX",
    "house_no": "XXXXXX",
    "id_number": "34117XXXXXX334",
    "id_number_status": 1,
    "lane": "",
    "postal_code": "20150", # Automatic Retrieve from Database
    "process_time": 1.3018648624420166, # Seconds
    "province": "ชลบุรี",
    "religion": "",
    "request_id": null,
    "road": "",
    "sub_district": "หนองปรือ",
    "th_dob": "XX มี.ค. 2500",
    "th_expire": "XX มี.ค. 2568",
    "th_fname": "XXXXX",
    "th_init": "นาง",
    "th_issue": "XX ก.ค. 2559",
    "th_lname": "โลเปซ",
    "th_name": "นาง XXXXX โลเปซ",
    "village": "",
    "village_no": "7",
    "confidence": {
        "id_number": 0.95,
        "th_name": 0.95,
        "th_fname": 0.95,
        "th_lname": 0.95,
        "en_name": 0.95,
        "en_fname": 0.95,
        "en_lname": 0.95,
        "th_dob": 0.9,
        "en_dob": 0.9,
        "th_issue": 0.9,
        "en_issue": 0.9,
        "th_expire": 0.9,
        "en_expire": 0.9,
        "address": 0.95,
        "gender": 0.95,
        "religion": 0.9
    }
}


Backside​

Thai National ID Card Example (Back side)

Request:​


curl --location --request POST 'https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/back' \
    --header 'apikey: {Your API Key}' \
    --form 'file=@"path/to/id-card-back.jpg"'


Response:​


{
    "back_number": "JT0-XXXXXXX-05",
    "detection_score": 0.99846746524175,
    "process_time": 1.370201416015625
}


Features & Capabilities​


Core Features​


    

  • High accuracy text extraction (98.13% character-level accuracy)
    • 

  • Fast processing time (1-3 seconds per card)
    • 

  • Support for multiple file formats (JPEG, JPG, PNG, HEIC, HEIF, PDF)
    • 

  • Automatic card cropping and rotation
    • 

  • Return bounding boxes and scores for fields
    • 

  • Return base64 images of card and fields
    • 

  • Return raw OCR text
    • 

  • Support for back card side without chip
    • 



Supported Fields​


Front Side​


FieldTypeDescription
addressStringAddress on the ID card
detection_scorefloatDetection score of a related field
districtStringDistrict name on the ID card
en_dobStringDate of birth, in English
en_expireStringDate of expiry, in English
en_fnameStringEnglish given name
en_initStringName title, in English
en_issueStringDate of issue, in Thai
en_lnameStringEnglish surname
en_nameStringEnglish given name and surname
error_messageStringError message
faceStringBase64 character string converted from the image
genderStringGender
home_addressStringHome address on the ID card
id_numberStringNational ID number
postal_codeStringPostal Code
process_timeStringProcessing time (Sec.)
provinceStringProvince name on the ID card
religionStringReligion on the ID card
sub_districtStringSub district name on the ID card
th_dobStringDate of birth, in Thai
th_expireStringDate of expiry, in Thai
th_fnameStringThai given name
th_initStringName title, in English
th_issueStringDate of issue
th_lnameStringThai surname
th_nameStringThai given name and surname
confidenceObjectConfidence scores (0-1) for each extracted field


Back side​


FieldTypeDescription
back_numberStringLaser number on back of ID card


Common Response Fields​


FieldTypeDescription
detection_scoreFloatConfidence score (0-1)
error_messageStringError message if request fails
process_timeFloatProcessing time in seconds


API Endpoints​


EndpointMethodDescriptionCost
POST /v3/store/ekyc/thai-national-id-card/front
Legacy: /thai-national-id-card/v3.5/front		POSTExtracts detailed information from the front side of Thai ID card1.25 IC per request
POST /v3/store/ekyc/thai-national-id-card/back
Legacy: /thai-national-id-card/v3.5.1/back		POSTExtracts information from the back side of Thai ID card0.75 IC per request


API Reference​


Thai National ID Card Endpoints​


1. Thai National ID Card - Front Side​


POST /v3/store/ekyc/thai-national-id-card/front


Extracts detailed information from the front side of a Thai national ID card.


Request Headers​


NameTypeRequiredDescription
apikeystringYesYour API key


Request Body (multipart/form-data)​


ParameterTypeRequiredDescription
fileFileYesThe binary data of the image (front side)
fieldsStringNoOption to choose fields in output
optionsStringNoOption to choose processing tools and settings




2. Thai National ID Card - Back Side​


POST /v3/store/ekyc/thai-national-id-card/back


Extracts information from the back side of a Thai national ID card.


Request Headers​


NameTypeRequiredDescription
apikeystringYesYour API key


Request Body (multipart/form-data)​


ParameterTypeRequiredDescription
fileFileYesThe binary data of the image (back side)
optionsStringNoOption to choose processing tools and settings


Available Options​


    

  • not_crop_card - Skip card cropping
    • 

  • not_rotate_card - Skip auto-rotation
    • 

  • get_bbox - Return bounding box coordinates
    • 

  • get_image - Return processed image
    • 

  • get_original - Return original image
    • 



Response Format for Available Options​


When using the available options, the response JSON will include additional fields based on the options selected:


Response with get_bbox Option​


Returns bounding box coordinates for each detected field in the format [x1, y1, x2, y2] with confidence score:


{
    "bbox": {
        "address": [
            [[119, 292, 376, 334], 0.991],
            [[75, 330, 255, 362], 0.999]
        ],
        "card": [[[0, 0, 713, 462], 0.99]],
        "en_dob": [[[370, 235, 526, 266], 0.999]],
        "face": [[[544, 218, 708, 407], 0.999]]
        // Other field coordinates...
    }
}


Response with get_image Option​


Returns base64 encoded cropped images for each detected field:


{
    "image": {
        "address": ["/9j/4AAQSk...", "/9j/4AAQSk..."],
        "card": ["/9j/4AAQSk..."],
        "face": ["/9j/4AAQSk..."],
        "id_number": ["/9j/4AAQSk..."]
        // Other field images...
    }
}


Response with get_original Option​


Returns the original values before the autocorrect step (which occured in the post processing step) detected from the card:


{
    "original": {
        "address": "XXXXX XXXXX X ต.หนองปรือ อ.บางละมุง จ.ชลบุรี",
        "en_dob": "XX Mar. 1957",
        "en_expire": "XX Mar. 2025",
        "th_name": "นาง XXXXXX โลเปซ"
        // Other original field values...
    }
}


The response will always include the standard fields like detection_score, error_message, and process_time regardless of options used.


Error Code​


Specific Error Messages​


Thai National ID Card Front Side​


Status CodeStatus MessageDescription
420NO_ID_CARD_FOUNDThe image file is not the ID card
421IMAGE_ERROR_UNSUPPORTED_FORMATThe image cannot be resolved. The file format may not be supported or the file is damaged
422INVALID_IMAGE_SIZEThe size of the uploaded image does not meet the requirement
424PLEASE_VERIFY_ID_CARD_NUMBERThe National ID Number has 13 digits but is incorrect. Response code 424 will show when using id_check option
425CANNOT_READ_ID_CARD_NUMBER_CLEARLYThe National ID Number has less than 13 digits. Response code 425 will show when using id_check option
426IMAGE_ERROR_UNSUPPORTED_BLACK_WHITE_IMAGEUsed gray_check option to check black-white and gray images


Thai National ID Card Back Side​


Status CodeStatus MessageDescription
430NO_ID_CARD_FOUNDThe image file is not the ID Card
431IMAGE_ERROR_UNSUPPORTED_FORMATThe image cannot be resolved. The file format may not be supported or the file is damaged
432INVALID_IMAGE_SIZEThe size of the uploaded image does not meet the requirement
434LASER_NUMBER_NOT_FOUNDCannot detect the laser number on back ID Card
435CANNOT_READ_LASER_NUMBER_CLEARLYThe laser number has less than 12 digits. Response code 435 will show when using id_check option
436IMAGE_ERROR_UNSUPPORTED_BLACK_WHITE_IMAGEUsed gray_check option to check black-white and gray images


Common Error Messages​


Status CodeStatus MessageDescription
404REQUESTED_URL_NOT_FOUNDAPI Route not found in request
405METHOD_NOT_ALLOWEDMethod name (GET, POST) in the URL is incorrect
413FILE_IS_TOO_LARGE: (more than 2 MB)The file size is too large
427LONG_TIME_TO_PROCESSThe server is processed for a long time
428LONG_TIME_TO_REQUESTThe client is waiting in the queue for a long time
461NO_FILE_ATTACHEDNo file attached
560SERVER_IS_BUSY: (Please try again in a few seconds.)Server is working on many requests
563ID_CARD_API_NOT_SUPPORT_THIS_IMAGEThe API has an error in the process


Code Examples​


Curl​


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


Python​


import requests

url = "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front"

payload = {
    'options': 'get_bbox,get_image'
}

files = [
    ('file',('id-card.jpg',open('path/to/id-card.jpg','rb'),'image/jpeg'))
]

headers = {
    'apikey': 'YOUR_API_KEY'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)
print(response.json())


JavaScript​


const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")

const form = new FormData()
form.append("file", fs.createReadStream("path/to/id-card.jpg"))
form.append("options", "get_bbox,get_image")

const config = {
    method: "post",
    url: "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front",
    headers: {
        apikey: "YOUR_API_KEY",
        ...form.getHeaders(),
    },
    data: form,
}

axios(config)
    .then((response) => console.log(JSON.stringify(response.data)))
    .catch((error) => console.log(error))


PHP​


<?php
$curl = curl_init();

$post_data = array(
    'file'=> new CURLFile('path/to/id-card.jpg'),
    'options' => 'get_bbox,get_image'
);

curl_setopt_array($curl, array(
    CURLOPT_URL => 'https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_HTTPHEADER => array(
        'apikey: YOUR_API_KEY'
    ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>


Swift​


import Foundation

let headers = [
    "apikey": "YOUR_API_KEY"
]

let parameters = [
    [
        "name": "file",
        "fileName": "path/to/id-card.jpg"
    ],
    [
        "name": "options",
        "value": "get_bbox,get_image"
    ]
]

let boundary = "Boundary-\(UUID().uuidString)"
var body = ""
var error: Error? = nil

for param in parameters {
    if let fileName = param["fileName"] {
        let fileContent = try? String(contentsOfFile: fileName, encoding: .utf8)
        body += "--\(boundary)\r\n"
        body += "Content-Disposition:form-data; name=\"\(param["name"] ?? "")\""
        body += "; filename=\"\(fileName)\"\r\n"
        body += "Content-Type: image/jpeg\r\n\r\n"
        body += fileContent ?? ""
    } else {
        body += "--\(boundary)\r\n"
        body += "Content-Disposition:form-data; name=\"\(param["name"] ?? "")\"\r\n\r\n"
        body += param["value"] ?? ""
    }
}

let postData = body.data(using: .utf8)

var request = URLRequest(url: URL(string: "https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")!,timeoutInterval: Double.infinity)
request.addValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.httpMethod = "POST"
request.httpBody = postData

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data else {
        print(String(describing: error))
        return
    }
    print(String(data: data, encoding: .utf8)!)
}

task.resume()


Kotlin​


import okhttp3.*
import java.io.File

val client = OkHttpClient()

val mediaType = MediaType.parse("image/jpeg")
val file = File("path/to/id-card.jpg")
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
    .addFormDataPart("file", file.name, RequestBody.create(mediaType, file))
    .addFormDataPart("options", "get_bbox,get_image")
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(body)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body()?.string())
}


Java​


import java.io.File;
import okhttp3.*;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient().newBuilder().build();

        MediaType mediaType = MediaType.parse("image/jpeg");
        RequestBody body = new MultipartBody.Builder().setType(MultipartBody.FORM)
            .addFormDataPart("file", "id-card.jpg",
                RequestBody.create(mediaType, new File("path/to/id-card.jpg")))
            .addFormDataPart("options", "get_bbox,get_image")
            .build();

        Request request = new Request.Builder()
            .url("https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front")
            .method("POST", body)
            .addHeader("apikey", "YOUR_API_KEY")
            .build();

        try {
            Response response = client.newCall(request).execute();
            System.out.println(response.body().string());
        } catch(Exception e) {
            e.printStackTrace();
        }
    }
}


Dart​


import 'package:http/http.dart' as http;

void main() async {
    var request = http.MultipartRequest('POST',
        Uri.parse('https://api.iapp.co.th/v3/store/ekyc/thai-national-id-card/front'));

    request.files.add(await http.MultipartFile.fromPath(
        'file', 'path/to/id-card.jpg'));

    request.fields['options'] = 'get_bbox,get_image';

    request.headers.addAll({
        'apikey': 'YOUR_API_KEY'
    });

    http.StreamedResponse response = await request.send();

    if (response.statusCode == 200) {
        print(await response.stream.bytesToString());
    } else {
        print(response.reasonPhrase);
    }
}


Limitations and Best Practices​


Limitations​


    

  • Maximum file size: 10MB
    • 

  • Supported formats: JPEG, JPG, PNG, HEIC, HEIF, PDF
    • 



Best Practices​


    

  1. Ensure good image quality
    2. 

  2. Check detection_score in response
    3. 

  3. Handle error messages appropriately
    4. 

  4. Validate ID card number format
    5. 

  5. Consider using options parameter for specific needs
    6. 



Accuracy & Performance​


Overall Accuracy​


    

  • Detection score typically above 96%
    • 

  • Field-specific accuracy varies
    • 



Processing Speed​


    

  • Average: 1-2 seconds
    • 

  • May vary based on image size and quality
    • 



Factors Affecting Accuracy​


    

  1. Image Quality

      

    • Resolution (Minimum 300 DPS)
      • 

    • Lighting
      • 

    • Focus
      • 

    

    2. 

  2. Card Condition

      

    • Physical damage
      • 

    • Reflections
      • 

    • Text clarity
      • 

    

    3. 



Thai National ID Card Specifications​


Understanding the physical specifications of Thai National ID cards helps ensure optimal image capture for OCR processing.


Card Dimensions (ขนาดบัตรประชาชน)​


SpecificationMetricImperial (inches)
Width85.60 mm3.370 inches (3⅜")
Height53.98 mm2.125 inches (2⅛")
Thickness0.76 mm0.030 inches
Corner Radius3.18 mm0.125 inches


ขนาดบัตรประชาชน นิ้ว
บัตรประชาชนไทยมีขนาด 3.370 × 2.125 นิ้ว (85.60 × 53.98 มม.) ตามมาตรฐาน ISO/IEC 7810 ID-1 ซึ่งเป็นขนาดเดียวกับบัตรเครดิตทั่วโลก


Card Format Standards​


StandardDescription
FormatISO/IEC 7810 ID-1 (Credit card size)
MaterialPolycarbonate (PC) plastic
Chip TypeContact smart card chip (since 2005)
Data StorageBiometric data, digital certificate, fingerprint templates


Card Features​


    

  • Front Side: Photo, name (Thai/English), ID number, date of birth, address, issue/expiry dates, barcode
    • 

  • Back Side: Laser code (12-character alphanumeric)
    • 

  • Security Features: Hologram, UV printing, microtext, laser engraving
    • 

  • Smart Card Chip: Contains encrypted biometric data and digital signature
    • 



Image Requirements for OCR​


For optimal OCR accuracy, ensure your captured images meet these requirements:


RequirementRecommendedMinimum
Resolution600 DPI300 DPI
Image Width1000+ pixels600 pixels
Image Height630+ pixels400 pixels
File Size< 5 MB< 10 MB
FormatJPEG, PNGJPEG, PNG, HEIC, PDF


History​


VersionRelease DateAccuracyKey Improvements
3.5Nov 202298.13%New OCR Engine, Faster Processing
3.4Jul 202293.25%Added Thai Military Ranks
3.1-3.3May-Jul 202192.75%Internal Beta Release
3.0Feb 202191.75%Major Accuracy Improvements
2.0Feb 202085%Added Back Card Support
1.0Nov 201976%Initial Release


Pricing​


OperationProduction PathLegacy PathIC CostUnitOn-Premise
Thai National ID Card - Front Side/v3/store/ekyc/thai-national-id-card/front/thai-national-id-card/v3.5/front1.25 ICper 1 requestContact us
Thai National ID Card - Back Side/v3/store/ekyc/thai-national-id-card/back/thai-national-id-card/v3.5.1/back0.75 ICper 1 requestContact us