NOTE: We're in the process of rolling out the accounting API to all of the utilities we support. Accounting information is currently only available for ConEd, PCE, PG&E, PSE&G, SoCal Gas, SRP, Eversource, and SVCE.
This is the object representing a utility billing account.
/api/v2/accounting/billing-accounts
List or search your billing accounts
/api/v2/accounting/billing-accounts/123
Get a specific billing account
Attribute | Format | Description | Example |
---|---|---|---|
uid |
UID String | Unique identifier of the Billing Account. These uids may appear as integers, but they are not guaranteed to stay that way, so you should treat them as strings. | "12345b" |
authorization_uid |
UID String | The UID of the Authorization this Billing Account belongs to | "abc123" |
meter_uids |
List(UID String) | A list of the UIDs of the meters that belong to this Billing Account |
[
"12345a",
"12345b",
"33701f"
]
|
notes |
List(BillingAccountNote) | A list of any notes that apply to this Billing Account. Will be an empty list if no notes. | [{"type": "billing_summaries_strange", ...}] |
statement_dates |
List(ISO8601) | Timestamps of the statement dates of the Bills the Billing Account data was pulled from. | ["2016-01-05T12:35:24.653422+00:00"] |
blocks |
List(BillingAccountBlockType) | A list of the blocks available for this Billing Account. |
[
"base",
"sources"
]
|
{block_type} |
BillingAccountBlock | The contents of a Billing Account Block listed in the blocks list. |
{
"billing_contact": "Nobody", ...
}
|
// Billing account with base and sources blocks { "uid": "20113", "authorization_uid": "221389", "meter_uids": [ "112311", "112312", "112313", "112314" ], "statement_dates": [ "2018-05-01T04:00:00.000000+00:00", "2018-04-01T04:00:00.000000+00:00", "2018-03-01T04:00:00.000000+00:00", "2018-02-01T04:00:00.000000+00:00", "2018-01-01T04:00:00.000000+00:00", ], "blocks": [ "base", "sources" ], "base": { "billing_contact": "General Services Corporation", "billing_address": "123 Fake St, Anytown, NJ, 07001", "billing_account": "194500235561" }, "sources": [ { "type": "pdf", "raw_url": "https://utilityapi.com/api/v2/files/here_is_a_file.pdf" } ] }