Thai Receipt OCR

Reads a Thai receipt or tax invoice, printed or handwritten, and returns the issuer, the customer, every line item and the totals, with a confidence per field.

POST/ocr/v3/receipt/file

+1 endpoints

Try it

• Price1 ICper page
• Served104.8Kcalls

• v3.0
• Active

Input

OutputPOST /ocr/v3/receipt/file

invoiceType

ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ

invoiceBook

—

invoiceID

4504RC112566/004044

invoiceDate

27/11/2566

issuerName

หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)

issuerTaxID

0323560000723

items

itemNo: 1 itemName: ชาเขียวนม ร้อน ขนาดใหญ่ itemUnit: 1 itemUnitCost: 60 itemTotalCost: 60

totalCost

60

discount

0

totalCostAfterDiscount

60

vat

3.93

grandTotal

60

Every field, under ResponseOther endpoints: /receipt see Request

Request

curl -X POST https://api.iapp.co.th/ocr/v3/receipt/file \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@receipt.jpg"

Response

200OK. The fields are explained under Response.

{
    "message": "success",
    "processed": {
        "invoiceType": "ใบเสร็จรับเงิน/ใบกำกับภาษีอย่างย่อ",
        "invoiceBook": null,
        "invoiceID": "4504RC112566/004044",
        "invoiceDate": "27/11/2566",
        "issuerName": "หจก.บุญรอดคอฟฟี (ตลาดรัตนบุรี)",
        "issuerTaxID": "0323560000723",
        "items": [
            {
                "itemNo": 1,
                "itemName": "ชาเขียวนม ร้อน ขนาดใหญ่",
                "itemUnit": 1,
                "itemUnitCost": 60.0,
                "itemTotalCost": 60.0
            }
        ],
        "totalCost": 60.0,
        "discount": 0.0,
        "totalCostAfterDiscount": 60.0,
        "vat": 3.93,
        "grandTotal": 60.0
    },
    "confidence": {
        "invoiceType": 0.95,
        "invoiceBook": 0.9,
        "invoiceID": 0.95,
        "invoiceDate": 0.9,
        "issuerName": 0.95,
        "issuerTaxID": 0.95,
        "items": 0.9,
        "totalCost": 0.95,
        "discount": 0.95,
        "totalCostAfterDiscount": 0.95,
        "vat": 0.95,
        "grandTotal": 0.95
    },
    "process_ms": 6821
}

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 receipt. 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/receipt/file	The file	1 IC per page

/v3/store/ocr/receipt 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.invoiceTypeprocessed.invoiceBookprocessed.invoiceIDprocessed.invoiceDateprocessed.purchaseOrderID

The document: its title or type, book, number, date, and the linked purchase order

processed.issuerNameprocessed.issuerAddressprocessed.issuerTaxIDprocessed.issuerPhone

The issuer

processed.customerNameprocessed.customerAddressprocessed.customerTaxIDprocessed.customerPhone

The customer

processed.itemsarray

One entry per line

processed.items.itemNointeger

processed.items.itemCode

processed.items.itemNamestring

processed.items.itemUnitinteger

processed.items.itemUnitCostnumber

processed.items.itemTotalCostnumber

processed.totalCostprocessed.discountprocessed.totalCostAfterDiscountprocessed.vatprocessed.grandTotal

The totals, THB, to two decimals; vat is the 7% amount

messagestring

Status message

confidenceobject

Confidence per field, 0 to 1

process_msinteger

Processing time, in milliseconds

Status codes

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

Details

Measured

On a benchmark set of 10,000 Thai receipts.

Measure	Result
Invoice numbers	99.2%
Amounts	99.5%
Dates	98.7%
Line items	97.8%
All fields	98.8%
Time	5–10 s typical, 12 s at the 95th percentile, 15 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 documents.
• 10 requests per second per API key.
• Resolution under 300 dpi, poor light, damage, fading and handwritten changes lower accuracy.

Data handling

The service is GDPR and PDPA compliant.

Changelog

Version	Date	Changes
3.0	27 Dec 2024	First release.