New Utility Statement Available

Webhook posted when a new utility statement is discovered.

Request Body Schema

Property nameData typeRequired?Description
typestringyesValue: "new_utility_statement_available"
created_atstring <date-time>yes
dataobject (UtilityStatement)yes


Property nameData typeRequired?Description
tariffobject (Tariff)yesInformation about a tariff.
statement_datestring <date>yes
due_datestring <date>yes
service_start_datestring <date>yes
service_end_datestring <date>yes
utility_chargenumberyesTotal dollar amount billed by the utility on this statement.
supplier_chargenull or numberyesTotal dollar amount billed by the energy supplier.

Note: Not available for all utilities yet.
gas_chargenull or numberyesTotal dollar amount billed by the utility for natural gas.

Note: Not available for all utilities that provide gas service yet.
created_atstring <date-time>yes
updated_atstring <date-time>yes
pdf_urlnull or string yesA url to the utility created PDF bill for this statement. Note that this url will only be valid for 600 seconds.
final_billboolean or nullyesIndicates if this is the final bill that this account will receive before closing.
service_window_inclusive_of_end_datebooleanyesIndicates that the service window for this UtilityStatement includes the service_end_date.


Property nameData typeRequired?Description
main_tariff_idstringyesThe Genability 'masterTariffId' unique identifier for this tariff. See Genability documentation for details.
supplier_namestring or nullnoThe name of the retail electricity supplier or the community choice aggregator. If there is no retail electricity supplier or community choice aggregator, this field is null.
tariff_codestringyesAbbreviation code of the tariff used for this calculation.
tariff_namestringyesFull name of the tariff used for this calculation.
utility_namestringyesName of the utility associated with this tariff

Request sample

Content type: application/json

  "type": "new_utility_statement_available",
  "created_at": "2019-08-24T14:15:22Z",
  "data": {
    "id": 123,
    "client_user_id": "fff57dc7-3a2b-4395-8a62-e3486d46dabe",
    "tariff": {
      "master_tariff_id": "gen_mtid_3331108",
      "main_tariff_id": "gen_mtid_3331108",
      "supplier_name": "East Bay Community Energy",
      "tariff_code": "EV-2A-TOU",
      "tariff_name": "Residential - Time of Use - Plug-In Electric Vehicle 2",
      "utility_name": "Pacific Gas & Electric"
    "utility_name": "Pacific Gas & Electric",
    "utility_account_id": 2243,
    "statement_date": "2019-08-24",
    "due_date": "2019-09-24",
    "service_start_date": "2019-08-24",
    "service_end_date": "2019-09-24",
    "kwh": 100,
    "utility_charge": 90.33,
    "supplier_charge": 41.54,
    "gas_charge": 23.32,
    "past_due": false,
    "created_at": "2019-08-24T14:15:22Z",
    "updated_at": "2019-08-24T14:15:22Z",
    "sandboxed": false,
    "pdf_url": null,
    "final_bill": false,
    "service_window_inclusive_of_end_date": true