Energy data
What energy data the Data API returns and where to find it.
The Data API gives you access to a consumer's energy data once they have connected their energy account through a consent. Energy data is currently available in Australia, where it is shared by energy retailers (the institutions, or data holders) under the Consumer Data Right (CDR).
What you can retrieve
| Data | Endpoint | Consent required |
|---|---|---|
| Accounts and plan details | GET /v1/energy/accounts | Yes |
| Balances | GET /v1/energy/balances | Yes |
| Usage (interval reads) | GET /v1/energy/usage | Yes |
| Billing transactions | GET /v1/energy/billing | Yes |
| Invoices | GET /v1/energy/invoice | Yes |
| Service points | GET /v1/energy/service-points | Yes |
| Concessions | GET /v1/energy/concessions | Yes |
| Payment schedules | GET /v1/energy/payment-schedules | Yes |
| DER (solar, batteries) | GET /v1/energy/der | Yes |
| Market plans (product reference data) | GET /v1/energy/plans | No |
Tariff and solar feed-in details are nested inside the plan data returned with each account — see Understand energy tariff data and Read solar feed-in tariff data.
Where to go next
- Troubleshoot missing energy usage data
- Understand energy billing and invoice data
- Work with energy plans and product reference data
- Work with DER data
For full request and response schemas, see the API reference.