Understand energy billing and invoice data
How billing transactions and invoices are structured, and what to expect from different institutions.
The Data API exposes billing and invoice data retrieved from institutions — in Australia (CDR), energy retailers. This page explains how the two datasets differ and covers common questions about their contents.
Billing vs invoice endpoints
| Endpoint | Returns |
|---|---|
GET /v1/energy/billing | Billing transaction history — individual charges, payments, credits, and adjustments, each with a type and amount. |
GET /v1/energy/invoice | Invoice-level data — the full bills issued to the consumer, including line items, payment status, due date, and a breakdown of charges. |
Use billing transactions when you need a running ledger of account activity, and invoices when you need to reconstruct or display the bills a consumer actually received. Full schemas are in the API reference.
Gas charges in invoices
If a consumer has a combined gas and electricity account with the same institution, gas charges appear within the billing and invoice data for that account, under the relevant service point. Gas is not a separate API call.
If gas data seems to be missing, check whether the institution holds gas on a separate account (a second service point), and whether the consent covering that account has been granted.
Negative amounts
Negative amounts are normal and represent credits applied to the account — for example, solar feed-in credits, overpayment refunds, or promotional credits. A negative total balance means the consumer is in credit.
Inconsistent charge types
Some institutions return non-standard charge types or enum values that do not strictly follow the regulatory data standard. Fiskil passes data through as the institution returns it.
Handle unexpected enum values gracefully
If you receive a charge type or enum value you don't recognise, don't treat it as a fatal error in your application. Handle it gracefully, then report it to Fiskil support so it can be raised with the institution.
Missing invoice history
Invoice availability depends on the institution's systems. Some institutions only return recent invoices — for example, the last 12 months — and older history may not be available regardless of the consent's scope.