Billing Summaries

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 summary of utility billing information.

API Endpoints

GET /api/v2/accounting/billing-summaries List or search your billing summaries
GET /api/v2/accounting/billing-summaries/123 Get a specific billing summary

Attributes

Attribute	Format	Description	Example
`uid`	UID String	Unique identifier of the Billing Summary. These uids may appear as integers, but they are not guaranteed to stay that way, so you should treat them as strings.	`"12345b"`
`billing_account_uid`	UID String	The UID of the Billing Account this Billing Summary belongs to	`"fedcba9"`
`authorization_uid`	UID String	The UID of the Authorization this Billing Summary belongs to	`"abc123"`
`meter_uids`	List(UID String)	A list of the UIDs of the meters related to this billing summary. NOTE: Utilities may issue bills that have charges but no specific meters on them. In this case `meter_uids` will be an empty list.	`["110231", ...]`
`notes`	List(BillingSummaryNote)	A list of any notes that apply to this Billing Summary. Will be an empty list if no notes.	`[{"type": "audit_failed_on_new_charges", ...}]`
`blocks`	List(BillingSummaryBlockType)	A list of the blocks available for this Billing Summary.	`[ "base", "new_charges", "sources" ]`
`{block_type}`	BillingSummaryBlock	The contents of a Billing Summary Block listed in the blocks list.	`{ "name": "Electric Charges", "cost": 14.00, ... }`

Examples

// Example billing summary
{
    "uid": "61187",
    "authorization_uid": "97114",
    "billing_account_uid": "11244",
    "blocks": [
        "base",
        "new_charges",
        "sources",
    ],
    "base": {
        "amount_due": 19038.22,
        "amount_due_date": "2018-02-15T:00:00.000000+00:00",
        "new_balance_amount": 19038.22,
        "new_charges_amount": 19038.22,
        "previous_balance_amount": 0.0,
        "previous_balance_unpaid": 0.0,
        "previous_payment_amount": 19012.33,
        "statement_date": "2018-01-31T04:00:00.000000+00:00"
    },
    "new_charges": [
        {
            "cost": 2104.97,
            "name": "Gas charges"
        },
        {
            "cost": 2989.05,
            "name": "Electric charges"
        },
        {
            "cost": 11907.45,
            "name": "Electric supply charges - ANYTOWN ENERGY CO-OP"
        },
        {
            "cost": 2036.91,
            "name": "Gas supply charges - ANYTOWN GAS, LLC"
        }
    ],
    "sources": [
        {
            "type": "pdf",
            "raw_url": "https://utilityapi.com/api/v2/files/billing_summary_source.pdf"
        }
    ]
}