Thai Tax Deduction Certificate OCR

Reads a Thai withholding tax certificate (50 ทวิ) and returns the payer, the payee, each payment with its tax withheld, and the totals.

POST/ocr/v3/tax-deduction-certificate/file

+1 endpoints

Try it

Price1 ICper page
Served18.8Kcalls

Input

OutputPOST /ocr/v3/tax-deduction-certificate/file

documentType: หนังสือรับรองการหักภาษี ณ ที่จ่าย
documentForm: ภ.ง.ด.3
bookNumber: TX63XXXX
taxDeductor: name: บริษัท XXXXXXXXXX จำกัด taxId: 010XXXXXXXX64 address: XXXX เขตจอมทอง กรุงเทพมหานคร 10150
taxpayer: name: นายXXXXX เป็นตัวอย่าง taxId: 31XXXXXXXX123 address: XXXX เขตสาทร กรุงเทพมหานคร
paymentTypes: paymentDate: 02/09/63 amount: 12000 withholdingTax: 360
totalAmount: 12000
totalTax: 360
taxPayerMethod: ออกภาษีให้ตลอดไป

Every field, under ResponseOther endpoints: /tax-deduction-certificate see Request

Request

curl -X POST https://api.iapp.co.th/ocr/v3/tax-deduction-certificate/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@certificate.pdf"

Response

200OK. The fields are explained under Response.

{
  "message": "success",
  "processed": {
    "documentType": "หนังสือรับรองการหักภาษี ณ ที่จ่าย",
    "documentForm": "ภ.ง.ด.3",
    "bookNumber": "TX63XXXX",
    "taxDeductor": { "name": "บริษัท XXXXXXXXXX จำกัด", "taxId": "010XXXXXXXX64",
                     "address": "XXXX เขตจอมทอง กรุงเทพมหานคร 10150" },
    "taxpayer": { "name": "นายXXXXX เป็นตัวอย่าง", "taxId": "31XXXXXXXX123",
                  "address": "XXXX เขตสาทร กรุงเทพมหานคร" },
    "paymentTypes": [ { "paymentDate": "02/09/63", "amount": 12000.00, "withholdingTax": 360.00 } ],
    "totalAmount": 12000.00,
    "totalTax": 360.00,
    "taxPayerMethod": "ออกภาษีให้ตลอดไป"
  },
  "confidence": { "documentForm": 0.95, "taxDeductor": 0.95, "taxpayer": 0.95, "totalTax": 0.95 }
}

Request

multipart/form-data to /file. A PDF may run to 10 pages.

Headers

apikeystringrequired

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

Body

filefilerequired

The certificate. JPEG, PNG, HEIC, HEIF or PDF, up to 10 MB.

return_imageboolean

true to get the processed image back as Base64.

return_ocrboolean

true to include the raw OCR text.

Endpoint	Takes	Price
`/ocr/v3/tax-deduction-certificate/file`	The file	1 IC per page

/v3/store/ocr/tax-deduction-certificate is the same service under the store prefix.

Response

raw carries the OCR text when return_ocr is true.

processedobject

The fields read from the document

processed.documentTypeprocessed.documentFormprocessed.bookNumberprocessed.documentNumber

The document and its form: ภ.ง.ด.1ก, 1ก พิเศษ, 2, 2ก, 3, 3ก or 53

processed.taxDeductorobject

The payer who withheld

processed.taxpayerobject

The payee

processed.paymentTypesarray

One entry per payment

processed.totalAmountprocessed.totalTax

The totals

processed.socialSecurity

amount and year, when present

processed.taxPayerMethodstring

หักภาษี ณ ที่จ่าย, ออกภาษีให้ตลอดไป, ออกภาษีให้ครั้งเดียว, or อื่นๆ

messagestring

Status message

confidenceobject

Confidence per field, 0 to 1

Status codes

Code	Meaning
400	Invalid parameters or file format
404	Unknown endpoint
500	Processing failed

Details

Measured

On a benchmark set of 5,000 Thai tax deduction certificates.

Measure	Result
Certificate numbers	99.5%
Amounts	99.8%
Dates	99.0%
Tax IDs	99.7%
All fields	99.5%
Time per document	25–30 s typical, 45 s at the 95th percentile, 67 s at most

Standard layouts read at 99% or better, non-standard layouts at 95% or better, handwritten elements at 90% or better.

Limits

Thai-language certificates only.
Resolution under 300 dpi, poor light, damage, fading and handwritten changes lower accuracy.
10 requests per second per API key.

Data handling

The service is GDPR and PDPA compliant.

Changelog

Version	Date	Changes
3.0	27 Dec 2024	First release.

Request​

Response​

Details​

Request

Response

Details