Electricity Bill OCR

Reads a Thai electricity bill from MEA or PEA and returns the customer, the readings and the charges.

POST/ocr/v3/electricity-bill/fileTry it

• Price1 ICper page
• Served18.6Kcalls

• v1.0
• Active

Input

OutputPOST /ocr/v3/electricity-bill/file

provider

การไฟฟ้านครหลวง

customer_name

นายสมศักดิ์ รักการเรียน

customer_address

12/5 ม.7 ต.ไทรน้อย อ.ไทรน้อย จ.นนทบุรี

account_number

012345678

invoice_number

00962934584

tariff_type

1.2

reading_date

15/08/64

last_reading

6704

previous_reading

6542

units_consumed

162

energy_charge

537.92

service_charge

38.22

ft_rate_per_unit

-0.1532

ft_charge

-24.82

discount

0

subtotal_before_vat

551.32

vat_amount

38.59

total_current_bill

589.91

due_date

31/08/64

Every field, under Response

Request

curl -X POST "https://api.iapp.co.th/ocr/v3/electricity-bill/file" \
  -H "apikey: YOUR_API_KEY" \
  -F "file=@/path/to/document.pdf" \
  -F "target_lang=th" \
  -F "include_confidence=true"

Response

200OK. The fields are explained under Response.

{
    "docs": [
        {
            "message": "success",
            "raw": {},
            "processed": {
                        "provider": "การไฟฟ้านครหลวง",
                        "customer_name": "นายสมศักดิ์ รักการเรียน",
                        "customer_address": "12/5 ม.7 ต.ไทรน้อย อ.ไทรน้อย จ.นนทบุรี",
                        "account_number": "012345678",
                        "invoice_number": "00962934584",
                        "tariff_type": "1.2",
                        "reading_date": "15/08/64",
                        "last_reading": 6704,
                        "previous_reading": 6542,
                        "units_consumed": 162,
                        "energy_charge": 537.92,
                        "service_charge": 38.22,
                        "ft_rate_per_unit": -0.1532,
                        "ft_charge": -24.82,
                        "discount": 0.0,
                        "subtotal_before_vat": 551.32,
                        "vat_amount": 38.59,
                        "total_current_bill": 589.91,
                        "due_date": "31/08/64"
            },
            "confidence": {
                        "provider": 0.95,
                        "customer_name": 0.95,
                        "customer_address": 0.95,
                        "account_number": 0.95,
                        "invoice_number": 0.95,
                        "tariff_type": 0.95
            },
            "process_ms": 4120
        }
    ],
    "docs_count": 1,
    "process_ms": 4300
}

Request

multipart/form-data only; there is no Base64 form. Every page of a PDF is read and billed.

Headers

apikeystringrequired

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

Body

filefilerequired

The bill. PDF, JPEG, PNG or WEBP, up to 50 MB. Repeatable: several documents in one request.

return_ocrboolean

true to include the raw OCR text.

target_langstring

The language of the extracted values: th, the default, or en.

include_confidenceboolean

Default true: a confidence from 0.00 to 1.00 per field.

/v3/store/ocr/electricity-bill is the same endpoint under the store prefix.

Response

The iapp-input-pages header carries the number of pages billed.

docsarray

One entry per document read

docs.processedobject

The fields read from the document

docs.processed.providerstring

The issuing authority, for example การไฟฟ้านครหลวง

docs.processed.customer_namedocs.processed.customer_address

The customer and the service address

docs.processed.account_numberdocs.processed.invoice_number

The customer account (CA) and the bill or tax invoice number

docs.processed.tariff_typestring

The tariff category, for example 1.2

docs.processed.reading_datedocs.processed.last_readingdocs.processed.previous_readingdocs.processed.units_consumed

The reading date, the two readings, and the kWh consumed

docs.processed.energy_chargedocs.processed.service_chargedocs.processed.ft_rate_per_unitdocs.processed.ft_chargedocs.processed.discount

The charges, THB; ft_charge may be negative

docs.processed.subtotal_before_vatdocs.processed.vat_amountdocs.processed.total_current_bill

The totals, THB

docs.processed.due_datestring

When payment is due

docs.messagestring

Status message

docs.rawobject

The OCR text, when requested

docs.confidenceobject

Confidence per field, 0 to 1

docs.process_msinteger

Processing time, in milliseconds

docs_countinteger

Number of documents read

process_msinteger

Processing time, in milliseconds

Status codes

Code	Meaning
400	Unsupported file extension, or a file over 50 MB
404	Unknown document type in the URL
422	No file attached
500	Processing error; the response carries a code to quote to support

Details

Measured

Field-level accuracy on an internal set of real Thai documents with labels re-verified by eye, including low-resolution photographs and bills partly covered by handwriting.

Measure	Result
Electricity bill, 5 documents, 45 fields	97.8%
All six document types, 25 documents, 147 fields	98.6%

Limits

• Up to 50 MB per request.
• Only the fields above are extracted.
• Degraded scans, glare and handwriting over printed values lower accuracy. Prefer the original PDF, a square-on photograph in even light, or a scan at 300 dpi or more, and route low-confidence fields to review.

Data handling

The service is GDPR and PDPA compliant.