The AER shares energy plan information to help enhance transparency and empower consumers to make informed decisions. You can access up-to-date energy plan data with no accreditation required.
As a designated data holder under the Consumer Data Right (CDR), the AER provides energy Product Reference Data (PRD) to help developers integrate energy plan information into their applications.
The Get Generic Plans and Get Generic Plan Detail APIs provide access to generic energy plan data held by the AER and Victoria’s Department of Energy, Environment and Climate Action. This is the same information that is used for both Energy Made Easy and Victoria Energy Compare.
The data includes details about:
You can access Energy Product Reference Data from our APIs. To do this, you’ll need to have the right software to make HTTP requests.
A guide to accessing Energy Product Reference Data
Uniform Resource Identifiers (URIs) are used to identify retailers. You can use a retailer’s URI with the Get Energy Plans to find information about plans offered by that specific retailer.
A list of CDR Energy base URIs
The AER continues to implement its consumer Data Right solution in alignment with the Consumer Data Standards.
| Get Generic Plan Detail endpoint | |
| 3 March 2025 | Version 2 is retired and no longer available to data recipients. Version 3 is available and compliant with the Consumer Data Standards. |
Our APIs are public, so they don’t require accreditation. Use of other APIs, however, may require accreditation to access. Please refer to the Consumer Data Standard (CDS) and the Australian Competition and Consumer Commission (ACCC) for further details:
The AER previously decided to restrict the Get Generic Plans API to only display plans per retailer. We are looking to remove this restriction in the future. Get Generic Plan Detail is restricted to one plan only.
The AER provides data from the Get Generic Plans endpoint, which includes access to current plans. Future and historical plans cannot be accessed.
The ability to access future and historical plans could be reviewed based on Data Recipient feedback to cdr-support
aer [dot] gov [dot] au (cdr-support[at]aer[dot]gov[dot]au).
Currently, there are no APIs that will access energy plans Australia wide. The APIs Get Generic Plans and Get Generic Plan Detail cover those jurisdictions who have adopted the National Energy Customer Framework: Tasmania, Victoria, South Australia, Australian Capital Territory, New South Wales and Queensland.
For those jurisdictions who haven’t (Western Australia and the Northern Territory), please refer to the applicable State or Territory regulator website for more information.
Information on specific guidelines for integrating the APIs with external systems can be found on the Consumer Data Standards website.
The Non-Functional Requirements set out in the Consumer Data Right (CDR) provides information on endpoint performance and can be found here.
The maximum number of records per API call is 1000.
The default endpoint returns one page of 25 plans. To access, you must make a separate call for each page. This can be modified by setting the page request parameter to the required page number.
Alternatively, setting the page-size request parameter to a maximum of 1000 will enable you to reduce the number of pages (and calls) to retrieve all plans.
The maximum number of records is 1 because this API is per plan.
This error occurs because the Get Generic Plans API only supports version 1, while the Get Generic Plan Detail API has versions greater than 1.
To resolve this issue, make sure to use the correct API call for the Get Generic Plans by sending a request to:
https://cdr.energymadeeasy.gov.au/agl/cds-au/v1/energy/plans?type=ALL&fuelType=ALL&effective=ALL
Include the following headers:
x-v = 1
x-min-v = 1
Currently no, but we are working on providing this in JSON format.
A plan can only belong to one Energy Retailer. Each Energy Retailer will have their own plans and do not share plans.
Plan values are permanently fixed, but there can be new iterations of a plan based on it being a newer version of the same plan. This would be indicated by a change in the last number in the plan ID, such as from 1 to 2, to reflect the newer version of the plan.
Alternatively, the plan may be re-uploaded with a new plan ID.
There are no unique or variable fields. The fields are governed by the Consumer Data Standards (CDS). The AER and the Energy Retailers comply with these fields.
It is up to the Energy Retailer to choose which optional fields they include as part of their plan.
If you need any further information from our APIs, the Consumer Data Right (CDR) Standards will require updating. Information on creating a change request with Consumer Data Standards Australia can be found here:
Creating a Change Request – Consumer Data Standards Australia.
If data from an Energy Retailer is not as expected, please contact us at cdr-supportaer [dot] gov [dot] au (cdr-support[at]aer[dot]gov[dot]au) to report the problem. We will then raise your concern with the applicable Energy Retailer.
Controlled Load
Controlled load is not a mandatory field for all electricity plans. Controlled load only applies if there is a controlled load set up with the customer. Customers can still choose a plan with a controlled load even if they do not have a controlled load themselves.
Controlled load is not applicable to gas, it applies to electricity only.
Daily Supply Charges
All plans come with a Daily Supply Charge which is used to pass distributors costs on to the consumer. Daily Supply Charges apply to both electricity and gas.
Excluded Postcodes
Excluded postcodes refer to a specific postcode where a plan is not available. Excluded Postcodes are not required for all plans. This is an optional field.
Demand Charges
Demand charges are not mandatory for plans. Demand charges only apply to electricity plans for customers with smart meters installed.
Discounts
Discounts are a not a mandatory field in all plans, as it is up to the Electricity Retailer to decide if discounts form part of their plan. There are no specific rules relating to the calculation of any discounts, which do not have to be applied equally to gas or electricity if the Electricity Retailer offers them as part of a plan.
Discounts are either a dollar figure or a percentage of the plan, whereas incentives are things that the customer receives, such as free Netflix or movie tickets.
Banded Daily Supply Charges
Banded daily supply charges only apply to selected plans in Queensland.
Additional Information
Additional Information is not a mandatory field. This refers to fees and changes that an Electricity Retailer may apply to specific plans.
Have questions not answered by this page?
cdr-supportaer [dot] gov [dot] au (Contact cdr-support[at]aer[dot]gov[dot]au)