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

• Full name
• Address (Split across address lines)
• Account number

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",
    "address1": "55 Sample Street, Sample Town, Sampleton",
    "address7": "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"
}