Utility bill

Utility bills are uploaded through the documents endpoint which details file types and size limitations.

Extracted data

These are the extracted fields of an Utility bill

Customer information

Extracted information on the customer of the utility bill

Field	Description
Full Name	Full name found on the utility bill
Account number	Account number found on the utility bill
Address1	House Number
Address2	House Name
Address3	Flat, unit, or apartment identifier if applicable
Address4	Street name or road
Address5	Smaller locality or village if applicable
Address6	City or Town name
Address7	County or region name
Postcode	Post code
Country	ISO 2 letter country code

Provider information

Extracted information on the utility provider

• Provider name
• Provider address
• Provider contact number

Bill information

• Bill number
• Issue date
• Due date
• Period start date
• Period end date
• Total amount due
• Payment method
• Usage details including the usage type, amount used and total usage cost

Other account financial information

• Previous account balance
• Last payment date
• Last payment amount

Example extraction

An example extraction followed by the utility bill image it was extracted from.

{
    "fullName": "Mr A B Sample",
    "fullAddress": "55 Sample Street, Sample Town, Sampleton, 555 555",
    "address1": "55",
    "address4":"Sample Street",
    "address6":"Sample Town",
    "address7":"Sampleton",
    "postcode": "S55 5SS",
    "periodStartDate": "2025-04-01T00:00:00",
    "periodEndDate": "2026-03-31T00:00:00",
    "accountNumber": "1234567-8",
    "providerName": "Affinity Water",
    "providerAddress": "N/A",
    "providerContactNumber": "0345 357 2402",
    "billDate": "2025-04-01",
    "billDueDate": "2026-03-31",
    "billNumber": "N/A",
    "previousBalance": "N/A",
    "currentCharges": "472.56",
    "vat": "N/A",
    "totalAmountDue": "472.56",
    "usageDetails": [
        {
            "usageType": "Water",
            "unitsUsed": "N/A",
            "unitRate": "N/A",
            "totalUsageCost": "N/A"
        }
    ],
    "lastPaymentDate": "N/A",
    "lastPaymentAmount": "N/A",
    "paymentMethod": "N/A"
}