Utility Bill

Fast and accurate data extraction and verification from about 11000+ Documents with support for 200 Countries

[POST]

{{baseUrl}}/api/v1/document/analysis/utility_bill

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Body parameter

Parameter	Type	Description	Required
input_type	string	url, defaults to url	required
input_value	string	Image URL of the Utility Bill	required

Response

Response

{
    "entity": {
        "result": {
            "status": "success",
            "message": ""
        },
        "identity_info": {
            "full_name": "JOHN DOE",
            "meter_number": "SBX12345678"
        },
        "address_info": {
            "street": "123 Sandbox Street SBX001",
            "city": "Testville",
            "state": "SB",
            "country": "Sandbox Country"
        },
        "provider_name": "Sandbox Power Company",
        "bill_issue_date": "2025-01-15",
        "amount_paid": "100",
        "metadata": {
            "extraction_date": "2025-08-15T00:00:00.000Z",
            "is_recent": true
        }
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the response data
entity.result	object	Operation result status
entity.result.status	string	Processing status (e.g., success)
entity.result.message	string	Additional status message, empty on success
entity.identity_info	object	Identity information extracted from the utility bill
entity.identity_info.full_name	string	Full name of the account holder
entity.identity_info.meter_number	string	Meter or account number on the bill
entity.address_info	object	Address information extracted from the utility bill
entity.address_info.street	string	Street address
entity.address_info.city	string	City name
entity.address_info.state	string	State or province
entity.address_info.country	string	Country name
entity.provider_name	string	Name of the utility service provider
entity.bill_issue_date	string	Date the bill was issued (YYYY-MM-DD format)
entity.amount_paid	string	Amount paid on the bill
entity.metadata	object	Additional extraction metadata
entity.metadata.extraction_date	string	Timestamp of when the data was extracted (ISO 8601 format)
entity.metadata.is_recent	boolean	Whether the bill is considered recent