Thai Credit Card Statement OCR

Reads a Thai credit card statement and returns the card, the holder, the bank, every transaction and the balances, with a confidence per field.

POST/ocr/v3/creditcard-statement/file

+1 endpoints

Try it

• Price1 ICper page
• Served18.8Kcalls

• v3.0
• Active

Input

OutputPOST /ocr/v3/creditcard-statement/file

statementType

ใบแจ้งยอดบัญชีบัตรเครดิต

statementDate

31/12/2566

dueDate

25/01/2567

cardNumber

4711-XXXX-XXXX-1234

cardHolderName

นาย ทดสอบ ระบบ

bankName

ธนาคารกสิกรไทย จำกัด (มหาชน)

creditLimit

100000

newBalancePayment

15789.4

minimumPaymentDue

789.47

transactions

transactionDate: 20/12 postingDate: 21/12 description: CHOKCHAI STEAK HOUSE PATHUMTHANI THA foreignAmount: — foreignCurrencyCode: — amountTHB: 1089

previousBalance

14789.4

thisPeriodBalance

15789.4

Every field, under ResponseOther endpoints: /creditcard-statement see Request

Request

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

Response

200OK. The fields are explained under Response.

{
  "message": "success",
  "processed": {
    "statementType": "ใบแจ้งยอดบัญชีบัตรเครดิต",
    "statementDate": "31/12/2566",
    "dueDate": "25/01/2567",
    "cardNumber": "4711-XXXX-XXXX-1234",
    "cardHolderName": "นาย ทดสอบ ระบบ",
    "bankName": "ธนาคารกสิกรไทย จำกัด (มหาชน)",
    "creditLimit": 100000.0,
    "newBalancePayment": 15789.4,
    "minimumPaymentDue": 789.47,
    "transactions": [
      { "transactionDate": "20/12", "postingDate": "21/12",
        "description": "CHOKCHAI STEAK HOUSE PATHUMTHANI THA",
        "foreignAmount": null, "foreignCurrencyCode": null, "amountTHB": 1089.0 }
    ],
    "previousBalance": 14789.4,
    "thisPeriodBalance": 15789.4
  },
  "confidence": { "cardNumber": 0.95, "newBalancePayment": 0.95, "transactions": 0.9 }
}

Request

multipart/form-data to /file, or the image as Base64 to /base64, as JSON or form data. A PDF may run to 10 pages.

Headers

apikeystringrequired

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

Body

filefilerequired

The statement. JPEG, PNG, HEIC, HEIF or PDF, up to 10 MB. On /base64, send base64_string instead.

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/creditcard-statement/file	The file	1 IC per page
/ocr/v3/creditcard-statement/base64	base64_string	1 IC per page

/v3/store/ocr/creditcard-statement is the same service under the store prefix.

Response

processed holds the fields below; raw carries the OCR text when return_ocr is true.

statementTypestatementDateclosingDatedueDate

The statement and its dates

cardNumbercardHolderName

The card, masked as printed, and its holder

bankNamebankAddressbankTaxIDbankPhonebankFax

The issuing bank

creditLimitinterestRatepaymentByDebitAccountNo

The limit, the rate in percent, and the linked debit account

transactionspayments_adjustment_others

One entry each: transactionDate, postingDate, description, foreignAmount, foreignCurrencyCode, amountTHB

previousBalancethisPeriodBalancenewBalancePaymentminimumPaymentDuetotalPaymentstotalInterestCharges

The balances, THB, to two decimals

reward

The points: accumulated, earned, bonus, adjusted, redeemed

paymentBarcodeNo

The payment barcode

messagestring

Status message

processedobject

The fields read from the document

processed.statementTypestring

processed.statementDatestring

processed.dueDatestring

processed.cardNumberstring

processed.cardHolderNamestring

processed.bankNamestring

processed.creditLimitnumber

processed.newBalancePaymentnumber

processed.minimumPaymentDuenumber

processed.transactionsarray

processed.previousBalancenumber

processed.thisPeriodBalancenumber

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 over 1,000 Thai credit card statements.

Measure	Result
Card numbers	99.5%
Amounts	99.8%
Dates	99.0%
Transactions	98.5%
All fields	99.2%
Time	20–30 s typical, 45 s at the 95th percentile, 60 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.