Utility Bill

Utility bills are a type of invoice issued by a service provider for providing a functional service, such as electricity, water, telephone, or internet.

To use the Upload PDF endpoint for this document, you must use utility_bill in the form_type parameter. To learn more about Utility Bill processing, click here.

Field descriptions

The following fields are available on this document type:

JSON AttributeData TypeDescription
utility_bill-Part1:utilityBillTypeELECTRICITY, GAS, WATER, TELEPHONE, INTERNET, TRANSPORTATION, OTHER, MULTIPLEUtility Bill Type
utility_bill-Part1:serviceProviderTextService Provider
utility_bill-Part1:serviceProviderAddress:addressLine1TextService Provider Address
utility_bill-Part1:serviceProviderAddress:addressLine2TextService Provider Address
utility_bill-Part1:serviceProviderAddress:cityTextService Provider Address
utility_bill-Part1:serviceProviderAddress:stateStateService Provider Address
utility_bill-Part1:serviceProviderAddress:zipZIP CodeService Provider Address
utility_bill-Part1:serviceProviderIbanNumberTextService Provider IBAN Number
utility_bill-Part1:serviceProviderBicNumberTextService Provider BIC Number
utility_bill-Part2:accountHolderBillingNameTextAccount Holder Billing Name
utility_bill-Part2:accountHolderBillingAddress:addressLine1TextAccount Holder Billing Address
utility_bill-Part2:accountHolderBillingAddress:addressLine2TextAccount Holder Billing Address
utility_bill-Part2:accountHolderBillingAddress:cityTextAccount Holder Billing Address
utility_bill-Part2:accountHolderBillingAddress:stateStateAccount Holder Billing Address
utility_bill-Part2:accountHolderBillingAddress:zipZIP CodeAccount Holder Billing Address
utility_bill-Part2:serviceAddress:addressLine1TextService Address
utility_bill-Part2:serviceAddress:addressLine2TextService Address
utility_bill-Part2:serviceAddress:cityTextService Address
utility_bill-Part2:serviceAddress:stateStateService Address
utility_bill-Part2:serviceAddress:zipZIP CodeService Address
utility_bill-Part2:accountNumber(ServiceProvider)TextAccount Number (Service Provider)
utility_bill-Part3:periodStartDateDatePeriod Start Date
utility_bill-Part3:periodEndDateDatePeriod End Date
utility_bill-Part3:utilityBillDateDateUtility Bill Date
utility_bill-Part3:utilityDueDateDateUtility Due Date
utility_bill-Part3:priorPaymentPostingDateDatePrior Payment Posting Date
utility_bill-Part3:priorPaymentTotalPaidCommaamountPrior Payment Total Paid
utility_bill-Part3:summaryTotalChargesDueMoneySummary Total Charges Due
utility_bill-Part3:summaryTotalPaymentsMoneySummary Total Payments

Sample document

Sample JSON result

{
   "status":200,
   "response":{
      "pk":31927573,
      "uuid":"bc57a3a2-031a-4309-bb8f-31f25292feee",
      "name":"Utility Bill API",
      "created":"2023-04-11T14:32:01Z",
      "created_ts":"2023-04-11T14:32:01Z",
      "verified_pages_count":1,
      "book_status":"ACTIVE",
      "id":31927573,
      "forms":[
         {
            "pk":45811179,
            "uuid":"fa7e4fc7-781f-40fc-8fdd-303a80d665f1",
            "uploaded_doc_pk":53985266,
            "form_type":"UTILITY_BILL",
            "raw_fields":{
               "utility_bill-Part3:periodEndDate":{
                  "value":"01/31/2012",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:utilityDueDate":{
                  "value":"02/15/2012",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProvider":{
                  "value":"NEO GAS",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:utilityBillType":{
                  "value":"MULTIPLE",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:periodStartDate":{
                  "value":"01/01/2012",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:utilityBillDate":{
                  "value":"01/31/2012",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:serviceAddress:zip":{
                  "value":"99373",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:serviceAddress:city":{
                  "value":"DRY CREEK",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:serviceAddress:state":{
                  "value":"AL",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:summaryTotalPayments":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:priorPaymentTotalPaid":{
                  "value":"450.80",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:summaryTotalChargesDue":{
                  "value":"562.93",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part3:priorPaymentPostingDate":{
                  "value":"01/14/2012",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderBicNumber":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingName":{
                  "value":"CHARLEY V. RINEHURT",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderIbanNumber":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderAddress:zip":{
                  "value":"33401",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderAddress:city":{
                  "value":"WEST PALM BEACH",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:serviceAddress:addressLine1":{
                  "value":"4843 BLACKWELL STREET",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:serviceAddress:addressLine2":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderAddress:state":{
                  "value":"FL",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountNumber(ServiceProvider)":{
                  "value":"125-234-952",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingAddress:zip":{
                  "value":"99373",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingAddress:city":{
                  "value":"DRY CREEK",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingAddress:state":{
                  "value":"AL",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderAddress:addressLine1":{
                  "value":"4780 HOLT STRET",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part1:serviceProviderAddress:addressLine2":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingAddress:addressLine1":{
                  "value":"4843 BLACKWELL STREET",
                  "is_empty":false,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               },
               "utility_bill-Part2:accountHolderBillingAddress:addressLine2":{
                  "value":"",
                  "is_empty":true,
                  "alias_used":null,
                  "source_filename":"Ocrolus Sample PDF - Utility Bill.pdf"
               }
            },
            "form_config_pk":213722,
            "tables":[
               
            ],
            "attribute_data":null
         }
      ],
      "book_is_complete":true
   },
   "message":"OK"
}