AER Energy Product Reference Data - Get Generic Plans
Anonymous, unaccredited Consumer Data Right energy Product Reference Data endpoint operated by the AER. Returns a paged summary of all current, generally available retail energy plans for one retailer brand, covering plan name, fuel type, brand, distributor and postcode geography, plan type and effective dates. The retailer brand is a path segment taken from the AER's published list of CDR energy base URIs — for example https://cdr.energymadeeasy.gov.au/agl/cds-au/v1/energy/plans?type=ALL, which returned HTTP 200 with 1,343 AGL plans on 2026-07-27. Requires the x-v request header; only version 1 is supported and any other value returns 406. Default page size is 25, maximum 1000. There is no Australia-wide call — one request per retailer brand.
AER Energy Product Reference Data - Get Generic Plans is one of 3 APIs that Australian Energy Regulator publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Energy, Consumer Data Right, Product Reference Data, Electricity, and Gas. The published artifact set on APIs.io includes API documentation, an API reference, and an OpenAPI specification.
This API exposes 23 operations across 18 paths, organized into 7 resource areas, and defines 64 schemas. It is described by OpenAPI 3.0.3, at version 1.36.0.
Requests are made against a single base URL, https://mtls.dh.example.com/cds-au/v1.
Metadata
The identity and technical contract details declared by the specification.
Paths & Operations 23
Across 18 paths, the API surfaces 23 operations — 18 GET, 5 POST. They span 7 resource areas: Energy Plans, Electricity Service Points, Electricity Usage, Distributed Energy Resources, Energy Accounts, Energy Account Balances, Energy Account Billing. Each is listed below with its method, path, parameters, and response codes.
Energy Plan endpoints
Electricity Service Point endpoints
Electricity Usage endpoints
Distributed Energy Resource endpoints
Energy Account endpoints
Energy Account Balance endpoints
Energy Account Billing endpoints
Schemas 64
The contract defines 64 schemas that model the data the API accepts and returns. The most detailed are CommonPAFAddress (22 properties), EnergyPlanContractV3 (16 properties), EnergyPlan (14 properties), EnergyInvoice (14 properties). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Australian Energy Regulator 2
Other APIs Australian Energy Regulator publishes across the network.
This is an independent, third-party profile of AER Energy Product Reference Data - Get Generic Plans, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.