Combined Utility Bills

Combined 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_combine for the Upload endpoint.

Field Descriptions:

The model automatically detects data such as:

Session NameField NameData TypeDescription
Basic InformationAccount NumberStringCustomer's unique account number
Basic InformationCustomer NameStringFull name of the customer
Basic InformationVendor NameStringVendor name
Basic InformationInvoice NameStringInvoice name (if available)
Basic InformationService AddressStringService location address
Basic InformationService StateStringService location state
Basic InformationService CityStringService location city
Basic InformationService Zip CodeStringService location ZIP code
Basic InformationPrevious BalanceNumberPrevious balance
Basic InformationPayment ReceivedNumberPayment received
Basic InformationAdjustmentsStringAny adjustments made
Basic InformationBalance ForwardStringBalance carried forward
Basic InformationCurrent ChargesNumberTotal current charges
Basic InformationTaxes and Misc ChargesStringTaxes and miscellaneous charges
Basic InformationTotal Amount DueNumberTotal amount due
Basic InformationIssue DateDateInvoice issue date
Basic InformationService End DateDateService end date
Basic InformationService Start DateDateService start date
Basic InformationDue DateDateDue date for payment
Billing InformationCustomer NameStringCustomer Name
Billing InformationCustomer AddressStringCustomer Address
Billing InformationVendor NameStringVendor Name
Billing InformationVendor AddressStringVendor Address
ElectricMeter Number1StringElectric meter number
ElectricMeter Start Reading1NumberElectric meter information
ElectricMeter End Reading1NumberElectric meter information
ElectricTariff Name1StringElectric tariff name
ElectricConsumption1StringElectric consumption details
ElectricConsumption UOM1StringUnits of measurement for electric consumption
ElectricDemand1StringElectric demand details
ElectricDemand UOM1StringUnits of measurement for electric demand
ElectricLine ItemsTableList of electric charges
ElectricMeter InformationTableList of electric meter information
GasMeter Number1StringGas meter number
GasTariff Name1StringGas tariff name
GasMeter Start Reading1NumberGas meter information
GasMeter End Reading1NumberGas meter information
GasConsumption1StringGas consumption details
GasConsumption UOM1StringUnits of measurement for gas consumption
GasDemand1StringGas demand details
GasDemand UOM1StringUnits of measurement for gas demand
GasLine ItemsTableList of gas charges
GasMeter InformationTableList of gas meter information
WaterMeter Number1StringWater meter number
WaterTariff Name1StringWater tariff name
WaterMeter Start Reading1NumberWater meter information
WaterMeter End Reading1NumberWater meter information
WaterConsumption1StringWater consumption details
WaterConsumption UOM1StringUnits of measurement for water consumption
WaterDemand1StringWater demand details
WaterDemand UOM1StringUnits of measurement for water demand
WaterLine ItemsTableList of water charges
WaterMeter InformationTableList of water meter information

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

Version

  • Beta

Sample Utility Bill

Sample JSON Output

[    
  "data": {
        "Basic Information": {
            "Account Number": {
                "value": "1234567890-00002",
                "position": [
                    363,
                    241,
                    579,
                    266
                ],
                "confidence": 1.0,
                "review_required": false
            },
            "Customer Name": {
                "value": "JOHN Q CUSTOMER",
                "position": [
                    361,
                    286,
                    579,
                    308
                ],
                "confidence": 1,
                "review_required": false
            },
            "Vendor Name": {
                "value": "We Energies",
                "position": [
                    200,
                    1995,
                    341,
                    2029
                ],
                "confidence": 0,
                "review_required": true
            },
            "Invoice Name": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Service Address": {
                "value": "123 MAIN ST",
                "position": [
                    361,
                    314,
                    495,
                    336
                ],
                "confidence": 1,
                "review_required": false
            },
            "Service State": {
                "value": "WI",
                "position": [
                    481,
                    340,
                    508,
                    362
                ],
                "confidence": 1,
                "review_required": false
            },
            "Service City": {
                "value": "ANYTOWN",
                "position": [
                    361,
                    340,
                    475,
                    362
                ],
                "confidence": 1,
                "review_required": false
            },
            "Service Zip Code": {
                "value": "53221",
                "position": [
                    514,
                    340,
                    576,
                    362
                ],
                "confidence": 1,
                "review_required": false
            },
            "Previous Balance": {
                "value": 220.35,
                "position": [
                    1047,
                    397,
                    1127,
                    419
                ],
                "confidence": 1,
                "review_required": false
            },
            "Payment Received": {
                "value": -220.35,
                "position": [
                    1039,
                    422,
                    1127,
                    444
                ],
                "confidence": 1,
                "review_required": false
            },
            "Adjustments": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Balance Forward": {
                "value": 0.0,
                "position": [
                    1071,
                    448,
                    1127,
                    470
                ],
                "confidence": 1,
                "review_required": false
            },
            "Current Charges": {
                "value": 253.78,
                "position": [
                    1047,
                    472,
                    1128,
                    494
                ],
                "confidence": 1,
                "review_required": false
            },
            "Tax and Misc Charges": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Total Amount Due": {
                "value": 253.78,
                "position": [
                    1042,
                    241,
                    1132,
                    266
                ],
                "confidence": 1,
                "review_required": false
            },
            "Total Amount Due Line": {
                "value": 67.1,
                "position": [
                    1047,
                    1285,
                    1123,
                    1310
                ],
                "confidence": 1,
                "review_required": false
            },
            "Issue Date": {
                "value": "02/03/2023",
                "position": [
                    123,
                    241,
                    248,
                    266
                ],
                "confidence": 1,
                "review_required": false
            },
            "Service End Date": {
                "value": "02/02/2023",
                "position": [
                    1491,
                    336,
                    1602,
                    358
                ],
                "confidence": 1,
                "review_required": false
            },
            "Service Start Date": {
                "value": "01/05/2023",
                "position": [
                    1349,
                    336,
                    1460,
                    358
                ],
                "confidence": 1,
                "review_required": false
            },
            "Due Date": {
                "value": "02/28/2023",
                "position": [
                    1399,
                    241,
                    1524,
                    266
                ],
                "confidence": 1,
                "review_required": false
            }
        },
        "Billing Information": {
            "Customer Name": {
                "value": "JOHN Q CUSTOMER",
                "position": [
                    237,
                    1822,
                    438,
                    1852
                ],
                "confidence": 0,
                "review_required": true
            },
            "Customer Address": {
                "value": "ANYTOWN WI 53221",
                "position": [
                    237,
                    1890,
                    452,
                    1912
                ],
                "confidence": 1,
                "review_required": false
            },
            "Vendor Name": {
                "value": "We Energies",
                "position": [
                    200,
                    1995,
                    341,
                    2029
                ],
                "confidence": 0,
                "review_required": true
            },
            "Vendor Address": {
                "value": "Stream IL 60197-6042",
                "position": [
                    265,
                    2063,
                    513,
                    2097
                ],
                "confidence": 0,
                "review_required": true
            }
        },
        "Electric": {
            "Meter Number1": {
                "value": "NZT123456",
                "position": [
                    115,
                    592,
                    233,
                    614
                ],
                "confidence": 1,
                "review_required": false
            },
            "Tariff Name1": {
                "value": "Residential Electric Service Rg1",
                "position": [
                    50,
                    560,
                    388,
                    582
                ],
                "confidence": 1,
                "review_required": false
            },
            "Meter End Reading1": {
                "value": 11126.0,
                "position": [
                    889,
                    592,
                    951,
                    614
                ],
                "confidence": 0,
                "review_required": true
            },
            "Meter Start Reading1": {
                "value": -10089.0,
                "position": [
                    882,
                    618,
                    951,
                    640
                ],
                "confidence": 1,
                "review_required": false
            },
            "Consumption1": {
                "value": 1037.0,
                "position": [
                    901,
                    644,
                    951,
                    666
                ],
                "confidence": 0,
                "review_required": true
            },
            "Consumption UOM1": {
                "value": "KWH",
                "position": [
                    956,
                    644,
                    1007,
                    666
                ],
                "confidence": 1,
                "review_required": false
            },
            "Demand1": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Demand UOM1": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Meter Information": [
                {
                    "Tariff Name": {
                        "value": "Residential Electric Service Rg1",
                        "position": [
                            50,
                            560,
                            388,
                            582
                        ],
                        "confidence": 0.99,
                        "review_required": false
                    },
                    "Start Date": {
                        "value": "01/05/2023",
                        "position": [
                            1349,
                            336,
                            1460,
                            358
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "End Date": {
                        "value": "02/02/2023",
                        "position": [
                            1491,
                            336,
                            1602,
                            358
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Meter End Reading": {
                        "value": 11126.0,
                        "position": [
                            889,
                            592,
                            951,
                            614
                        ],
                        "confidence": 0.83,
                        "review_required": false
                    },
                    "Meter Start Reading": {
                        "value": -10089.0,
                        "position": [
                            882,
                            618,
                            951,
                            640
                        ],
                        "confidence": 0.93,
                        "review_required": false
                    },
                    "Consumption": {
                        "value": 1037.0,
                        "position": [
                            901,
                            644,
                            951,
                            666
                        ],
                        "confidence": 0.79,
                        "review_required": false
                    },
                    "Consumption UOM": {
                        "value": "KWH",
                        "position": [
                            956,
                            644,
                            1007,
                            666
                        ],
                        "confidence": 0.95,
                        "review_required": false
                    },
                    "Demand": {
                        "value": "",
                        "position": [],
                        "confidence": 0,
                        "review_required": true
                    },
                    "Demand UOM": {
                        "value": "",
                        "position": [],
                        "confidence": 0,
                        "review_required": true
                    }
                }
            ],
            "Line Items": [
                {
                    "Description": {
                        "value": "Customer Charge 29 Days at $0.49315",
                        "position": [
                            62,
                            702,
                            654,
                            724
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            702,
                            654,
                            724
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 14.3,
                        "position": [
                            978,
                            698,
                            1136,
                            724
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "Energy Charge 1,037 KWH at $0.16580",
                        "position": [
                            62,
                            728,
                            687,
                            750
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            728,
                            687,
                            750
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 171.93,
                        "position": [
                            978,
                            724,
                            1136,
                            750
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "Environmental Control Charge 1,037 KWH at $0.00043",
                        "position": [
                            62,
                            780,
                            687,
                            802
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            780,
                            687,
                            802
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 0.45,
                        "position": [
                            978,
                            775,
                            1136,
                            801
                        ],
                        "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": [
                            62,
                            806,
                            398,
                            828
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 3.15,
                        "position": [
                            978,
                            801,
                            1136,
                            827
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                }
            ]
        },
        "Gas": {
            "Meter Number1": {
                "value": "0WG0987654",
                "position": [
                    115,
                    964,
                    253,
                    986
                ],
                "confidence": 1,
                "review_required": false
            },
            "Tariff Name1": {
                "value": "Residential Gas Service (WGC) Rg-1",
                "position": [
                    50,
                    932,
                    433,
                    954
                ],
                "confidence": 1,
                "review_required": false
            },
            "Meter End Reading1": {
                "value": 9668.0,
                "position": [
                    901,
                    964,
                    951,
                    986
                ],
                "confidence": 1,
                "review_required": false
            },
            "Meter Start Reading1": {
                "value": -9614.0,
                "position": [
                    894,
                    990,
                    951,
                    1012
                ],
                "confidence": 1,
                "review_required": false
            },
            "Consumption1": {
                "value": 54.0,
                "position": [
                    925,
                    1016,
                    950,
                    1038
                ],
                "confidence": 1,
                "review_required": false
            },
            "Consumption UOM1": {
                "value": "CCF",
                "position": [
                    956,
                    1016,
                    1001,
                    1038
                ],
                "confidence": 1,
                "review_required": false
            },
            "Demand1": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Demand UOM1": {
                "value": "",
                "position": [],
                "confidence": 0,
                "review_required": true
            },
            "Meter Information": [
                {
                    "Tariff Name": {
                        "value": "Residential Gas Service (WGC) Rg-1",
                        "position": [
                            50,
                            932,
                            433,
                            954
                        ],
                        "confidence": 0.99,
                        "review_required": false
                    },
                    "Start Date": {
                        "value": "01/05/2023",
                        "position": [
                            1349,
                            336,
                            1460,
                            358
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "End Date": {
                        "value": "02/02/2023",
                        "position": [
                            1491,
                            336,
                            1602,
                            358
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Meter End Reading": {
                        "value": 9668.0,
                        "position": [
                            901,
                            964,
                            951,
                            986
                        ],
                        "confidence": 0.97,
                        "review_required": false
                    },
                    "Meter Start Reading": {
                        "value": -9614.0,
                        "position": [
                            894,
                            990,
                            951,
                            1012
                        ],
                        "confidence": 0.98,
                        "review_required": false
                    },
                    "Consumption": {
                        "value": 54.0,
                        "position": [
                            925,
                            1016,
                            950,
                            1038
                        ],
                        "confidence": 0.98,
                        "review_required": false
                    },
                    "Consumption UOM": {
                        "value": "CCF",
                        "position": [
                            956,
                            1016,
                            1001,
                            1038
                        ],
                        "confidence": 0.99,
                        "review_required": false
                    },
                    "Demand": {
                        "value": "",
                        "position": [],
                        "confidence": 0,
                        "review_required": true
                    },
                    "Demand UOM": {
                        "value": "",
                        "position": [],
                        "confidence": 0,
                        "review_required": true
                    }
                }
            ],
            "Line Items": [
                {
                    "Description": {
                        "value": "Customer Charge 29 Days at $0.33000",
                        "position": [
                            62,
                            1099,
                            654,
                            1121
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            1099,
                            654,
                            1121
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 9.57,
                        "position": [
                            986,
                            1092,
                            1141,
                            1119
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "Distribution 56.9 Therms at $0.3549",
                        "position": [
                            62,
                            1125,
                            685,
                            1147
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            1125,
                            685,
                            1147
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 20.19,
                        "position": [
                            986,
                            1119,
                            1141,
                            1145
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "Base Gas 56.9 Therms at $0.5088",
                        "position": [
                            62,
                            1177,
                            685,
                            1199
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            1177,
                            685,
                            1199
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 28.95,
                        "position": [
                            986,
                            1171,
                            1141,
                            1197
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "PGA 56.9 Therms at $0.13670 (27/29 Days)",
                        "position": [
                            62,
                            1203,
                            831,
                            1225
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            1203,
                            831,
                            1225
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 7.24,
                        "position": [
                            986,
                            1197,
                            1141,
                            1224
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                },
                {
                    "Description": {
                        "value": "PGA 56.9 Therms at $0.29260 (2/29 Days)",
                        "position": [
                            62,
                            1229,
                            819,
                            1251
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Quantity": {
                        "value": "",
                        "position": [
                            62,
                            1229,
                            819,
                            1251
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    },
                    "Charges": {
                        "value": 1.15,
                        "position": [
                            986,
                            1224,
                            1141,
                            1250
                        ],
                        "confidence": 1.0,
                        "review_required": false
                    }
                }
            ]
        },
]