Utility Bills
Utility Bill represents monthly statement of services owned by a home containing multiple utility information (like any combination of electricity, gas or water).
API Upload
The api_type parameter is utility_bill_generic for the Upload endpoint.
Field Descriptions:
The model automatically detects data such as:
| Section Name | Field Name | Data Type | Description |
|---|---|---|---|
| Basic Information | Vendor Name | String | Name of the vendor or service provider issuing the bill |
| Basic Information | Service Address | String | Physical address where the utility service is provided |
| Basic Information | Service State | String | Service location state |
| Basic Information | Service City | String | Service location city |
| Basic Information | Service Zip Code | String | Service location ZIP code |
| Basic Information | Previous Balance | Number | Outstanding balance or amount carried over from the previous billing cycle |
| Basic Information | Payment Received | Number | Total payments received since the last billing statement |
| Basic Information | Current Charges | Number | Total amount of charges incurred during the current billing period |
| Basic Information | Service Start Date | Date | Date on which the current utility service period began |
| Basic Information | Service End Date | Date | Date on which the current utility service period ended |
| Billing Information | Vendor Information | Table | |
| Account Number | String | Unique account identification number assigned to the customer/vendor | |
| Customer Name | String | Full name of the customer | |
| Customer Address | String | Customer Address | |
| Vendor Name | String | Vendor Name | |
| Vendor Address | String | Vendor Address | |
| Vendor Name Type | String | Indicates whether the vendor on the utility bill is the actual utility provider or a third-party supplier/reseller | |
| Utility | Meter Information | Table | |
| Account Number | String | Customer's unique account number | |
| Utility Type | String | Type of utility measured (such as electric, gas, or water) | |
| Meter Number | String | Unique identifier or serial number assigned to the utility meter | |
| Service Address | String | Address where the metered utility service is provided | |
| Tariff Name | String | Name or code identifying the pricing tariff or plan under which charges are calculated | |
| Reading Start Date | Date | Start date of the meter reading period for the billing cycle | |
| Reading End Date | Date | End date of the meter reading period for the billing cycle | |
| Meter Start Reading | Number | Meter's recorded value at the beginning of the billing period | |
| Meter End Reading | Number | Meter's recorded value at the end of the billing period | |
| Consumption | Number | Total amount of the utility used during the billing period, calculated from meter readings | |
| Consumption UOM | String | Unit of measurement for utility consumption (e.g., kWh, gallons, therms) | |
| Demand | Number | Maximum level of demand recorded during the billing period, if applicable | |
| Demand UOM | String | Unit of measurement for demand | |
| Total Current Charge | Number | Total charges associated with the metered utility usage for the billing cycle | |
| Charge Information | Table | List of charge information | |
| Account Number | String | Account number associated with the specific charge entry | |
| Utility Type | String | Type of utility relevant to the charge line (electric, water, gas, etc.) | |
| Meter Number | String | Meter number associated with the charge line item, if applicable | |
| Description | String | Explanation or brief label describing the nature of the charge | |
| Quantity | Number | Amount or quantity for which the charge is being calculated (e.g., units or hours) | |
| Rate | Number | Price per unit or rate applied to the quantity for this charge | |
| UOM | String | Unit of Measurement (UOM) applied to the quantity (e.g., kWh, gallons, therms) | |
| Charges | Number | Total amount billed for the specific charge line |
Coverage
- Majority USA Utility Provider
- Battle tested on
| Utility Companies |
|---|
| AEP Energy, Inc |
| Ameren Missouri |
| Appalachian Power |
| Atmos Energy |
| Atlantic Energy MD |
| CenterPoint Energy |
| Central Hudson Gas and Electric |
| City of Inglewood |
| City of Long Beach |
| City of North Las Vegas Utilities Department |
| Columbia Gas |
| Consolidated Edison Solutions, Inc. |
| Consumers Energy |
| Constellation New Energy Inc |
| Constellation NewEnergy, Inc. |
| Core Electric Cooperative |
| CPS Energy |
| Delta Natural Gas Co Inc |
| Direct Energy |
| Direct Energy Business |
| DTE Energy |
| Duke Energy |
| Duquesne Light Energy |
| EDF Energy Services |
| East Valley Water District |
| Engie Resources |
| Energy Plus Holdings |
| Entergy Texas Inc |
| Exelon Energy Company |
| First Energy |
| Golden State Water Company |
| Hudson Energy Services |
| KU a PPL Company |
| Long Island Power Solutions DBA New York Power Solutions |
| Los Angeles Department of Water & Power |
| National Grid Keyspan |
| New York State Electric & Gas |
| Northwest Natural |
| NRG Controllable Load Services |
| NV Energy |
| Ohio Edison |
| Orange and Rockland Utilities |
| Pacific Gas and Electric Company |
| Pacific Power |
| PECO Energy |
| Penelec, A FirstEnergy Company |
| Penn Power |
| Portland General Electric |
| PSEG Long Island |
| Puget Sound Energy |
| Reliant-NRG |
| Rochester Gas and Electric |
| Seattle City Light Bill |
| Snohomish County Public Utility District |
| Southern California Edison |
| Southern Federal Power |
| Southwest Gas |
| Spire |
| Tri-County Electric |
| Warren County Water District |
| Warren Rural Electric Cooperative Corporation |
| West Penn Power Co. |
| Xcel Energy |
The model might also work with other utility provide of US and other countries too. You can use this as a base model or fine-tune your own new model using just 50 samples. Here are the details: Fine-tune model on your data
Sample Utility Bill
Sample JSON Output
[
{
"data": {
"Basic Information": {
"Vendor Name": {
"value": "We Energies",
"position": [
200,
1994,
341,
2029
],
"confidence": 1.0,
"review_required": false
},
"Service Address": {
"value": "123 MAIN ST",
"position": [
361,
310,
495,
336
],
"confidence": 1.0,
"review_required": false
},
"Service State": {
"value": "WI",
"position": [
481,
336,
508,
362
],
"confidence": 1.0,
"review_required": false
},
"Service City": {
"value": "ANYTOWN",
"position": [
361,
336,
475,
362
],
"confidence": 1.0,
"review_required": false
},
"Service Zip Code": {
"value": "53221",
"position": [
514,
336,
576,
362
],
"confidence": 1.0,
"review_required": false
},
"Previous Balance": {
"value": 220.35,
"position": [
1047,
397,
1127,
419
],
"confidence": 0.92,
"review_required": false
},
"Payment Received": {
"value": -220.35,
"position": [
1039.0,
422.0,
1127.0,
444.0
],
"confidence": 1.0,
"review_required": false
},
"Current Charges": {
"value": 253.78,
"position": [
1047,
471,
1128,
494
],
"confidence": 0.92,
"review_required": false
},
"Service Start Date": {
"value": "01/05/2023",
"position": [
1349,
336,
1460,
358
],
"confidence": 1.0,
"review_required": false
},
"Service End Date": {
"value": "02/02/2023",
"position": [
1491,
336,
1602,
358
],
"confidence": 1.0,
"review_required": false
}
},
"Billing Information": {
"Vendor Information": [
{
"Account Number": {
"value": "1234567890-00002",
"position": [
363,
241,
579,
266
],
"confidence": 0.5,
"review_required": false
},
"Customer Name": {
"value": "JOHN Q CUSTOMER",
"position": [
361,
280,
579,
308
],
"confidence": 0.5,
"review_required": false
},
"Customer Address": {
"value": "123 MAIN ST ANYTOWN WI 53221",
"position": [
361,
310,
576,
362
],
"confidence": 0.5,
"review_required": false
},
"Vendor Name": {
"value": "We Energies",
"position": [
200,
1994,
341,
2029
],
"confidence": 1.0,
"review_required": false
},
"Vendor Address": {
"value": "PO Box 6042 Carol Stream IL 60197-6042",
"position": [
200,
2029,
513,
2097
],
"confidence": 1.0,
"review_required": false
},
"Vendor Name Type": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
}
}
]
},
"Utility": {
"Meter Information": [
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Electric",
"position": [
50,
526,
150,
557
],
"confidence": 0.5,
"review_required": false
},
"Meter Number": {
"value": "NZT123456",
"position": [
115,
592,
233,
614
],
"confidence": 1.0,
"review_required": false
},
"Service Address": {
"value": "123 MAIN ST ANYTOWN WI 53221",
"position": [
361,
310,
576,
362
],
"confidence": 1.0,
"review_required": false
},
"Tarrif Name": {
"value": "Residential Electric Service Rg1",
"position": [
50,
557,
388,
582
],
"confidence": 1.0,
"review_required": false
},
"Reading Start Date": {
"value": "01/05/2023",
"position": [
1349,
336,
1460,
358
],
"confidence": 0.5,
"review_required": false
},
"Reading End Date": {
"value": "02/03/2023",
"position": [
672,
592,
783,
614
],
"confidence": 1.0,
"review_required": false
},
"Meter Start Reading": {
"value": 10089.0,
"position": [
882,
612,
951,
640
],
"confidence": 1.0,
"review_required": false
},
"Meter End Reading": {
"value": 11126.0,
"position": [
889,
592,
951,
614
],
"confidence": 1.0,
"review_required": false
},
"Consumption": {
"value": 1037.0,
"position": [
1427,
526,
1470,
548
],
"confidence": 1.0,
"review_required": false
},
"Consumption UOW": {
"value": "KWH",
"position": [
1181,
526,
1227,
548
],
"confidence": 0.5,
"review_required": false
},
"Demand": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Demand UOM": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Total Current Charge": {
"value": 186.68,
"position": [
1046,
832,
1126,
854
],
"confidence": 0.5,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [
1234,
640,
1270,
660
],
"confidence": 0.5,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [
115,
964,
253,
986
],
"confidence": 1.0,
"review_required": false
},
"Service Address": {
"value": "123 MAIN ST ANYTOWN WI 53221",
"position": [
361,
310,
576,
362
],
"confidence": 1.0,
"review_required": false
},
"Tarrif Name": {
"value": "Residential Gas Service (WGC) Rg-1",
"position": [
50,
932,
433,
954
],
"confidence": 1.0,
"review_required": false
},
"Reading Start Date": {
"value": "01/04/2023",
"position": [
672,
990,
783,
1012
],
"confidence": 1.0,
"review_required": false
},
"Reading End Date": {
"value": "02/02/2023",
"position": [
1491,
336,
1602,
358
],
"confidence": 0.5,
"review_required": false
},
"Meter Start Reading": {
"value": 9614.0,
"position": [
894,
990,
951,
1012
],
"confidence": 1.0,
"review_required": false
},
"Meter End Reading": {
"value": 9668.0,
"position": [
901,
964,
951,
986
],
"confidence": 1.0,
"review_required": false
},
"Consumption": {
"value": 54.0,
"position": [
925,
1016,
950,
1038
],
"confidence": 1.0,
"review_required": false
},
"Consumption UOW": {
"value": "CCF",
"position": [
956,
1016,
1001,
1038
],
"confidence": 0.5,
"review_required": false
},
"Demand": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Demand UOM": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Total Current Charge": {
"value": 67.1,
"position": [
1058,
1255,
1126,
1277
],
"confidence": 0.5,
"review_required": false
}
}
],
"Charge Information": [
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Electric",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "NZT123456",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Customer Charge",
"position": [
62,
702,
654,
724
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 29.0,
"position": [
449,
702,
474,
724
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.49315,
"position": [
562,
702,
654,
724
],
"confidence": 0.93,
"review_required": false
},
"UOM": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 14.3,
"position": [
1058,
702,
1126,
724
],
"confidence": 0.8,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Electric",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "NZT123456",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Energy Charge",
"position": [
62,
728,
212,
750
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 1037.0,
"position": [
449,
728,
505,
750
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.1658,
"position": [
594,
728,
687,
750
],
"confidence": 0.86,
"review_required": false
},
"UOM": {
"value": "KWH",
"position": [
511,
728,
563,
750
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 171.93,
"position": [
1046,
728,
1126,
750
],
"confidence": 0.92,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Electric",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "NZT123456",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Environmental Control Charge",
"position": [
62,
780,
361,
802
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 1037.0,
"position": [
449,
780,
505,
802
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.00043,
"position": [
594,
780,
687,
802
],
"confidence": 0.93,
"review_required": false
},
"UOM": {
"value": "KWH",
"position": [
511,
780,
563,
802
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 0.45,
"position": [
1070,
780,
1126,
802
],
"confidence": 0.89,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Electric",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "NZT123456",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "State Low Income Assistance Fee",
"position": [
62,
806,
398,
828
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"UOM": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 3.15,
"position": [
1070,
806,
1126,
828
],
"confidence": 0.89,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Customer Charge",
"position": [
62,
1099,
654,
1121
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 29.0,
"position": [
449,
1099,
474,
1121
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.33,
"position": [],
"confidence": 1.0,
"review_required": false
},
"UOM": {
"value": "",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 9.57,
"position": [
1070,
1099,
1126,
1121
],
"confidence": 0.89,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Distribution",
"position": [
62,
1125,
173,
1147
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 56.9,
"position": [
449,
1125,
493,
1147
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.3549,
"position": [
605,
1125,
685,
1147
],
"confidence": 0.92,
"review_required": false
},
"UOM": {
"value": "Therms",
"position": [
499,
1125,
574,
1147
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 20.19,
"position": [
1058,
1125,
1126,
1147
],
"confidence": 0.91,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [
119,
1177,
160,
1199
],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "Base Gas",
"position": [
62,
1177,
160,
1199
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 56.9,
"position": [
449,
1177,
493,
1199
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.5088,
"position": [
605,
1177,
685,
1199
],
"confidence": 0.92,
"review_required": false
},
"UOM": {
"value": "Therms",
"position": [
499,
1177,
574,
1199
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 28.95,
"position": [
1058,
1177,
1126,
1199
],
"confidence": 0.91,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "PGA",
"position": [
62,
1203,
831,
1225
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 56.9,
"position": [
449,
1203,
493,
1225
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.1367,
"position": [
605,
1203,
698,
1225
],
"confidence": 0.86,
"review_required": false
},
"UOM": {
"value": "Therms",
"position": [
499,
1203,
574,
1225
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 7.24,
"position": [
1070,
1203,
1126,
1225
],
"confidence": 0.89,
"review_required": false
}
},
{
"Account Number": {
"value": "1234567890-00002",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Utility Type": {
"value": "Gas",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Meter Number": {
"value": "0WG0987654",
"position": [],
"confidence": 1.0,
"review_required": false
},
"Description": {
"value": "PGA",
"position": [
62,
1229,
819,
1251
],
"confidence": 1.0,
"review_required": false
},
"Quantity": {
"value": 56.9,
"position": [
449,
1229,
493,
1251
],
"confidence": 1.0,
"review_required": false
},
"Rate": {
"value": 0.2926,
"position": [
605,
1229,
698,
1251
],
"confidence": 0.86,
"review_required": false
},
"UOM": {
"value": "Therms",
"position": [
499,
1229,
574,
1251
],
"confidence": 1.0,
"review_required": false
},
"Charges": {
"value": 1.15,
"position": [
1070,
1229,
1126,
1251
],
"confidence": 0.89,
"review_required": false
}
}
]
}
}
}
]Updated about 2 hours ago