> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Utility Bill

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

```http [POST] theme={null}
{{baseUrl}}/api/v1/document/analysis/utility_bill
```

### Header

| Header        | Type   | Description                                                                                         |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId         | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| 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

```json Response theme={null}
{
    "entity": {
        "result": {
            "status": "success",
            "message": ""
        },
        "identity_info": {
            "full_name": "JOHN DOE MUSA",
            "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                      |