How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

AER Energy Product Reference Data - Get Generic Plan Detail

Anonymous, unaccredited Consumer Data Right energy Product Reference Data endpoint operated by the AER. Returns the full detail of a single current, generally available retail energy plan by plan identifier — tariff structures, metering charges, contract terms, incentives, discounts, fees, solar feed-in and eligibility. Version 3 is the supported version; version 2 was retired on 3 March 2025 and requests with x-v other than 3 return 406. Verified 2026-07-27 with GET https://cdr.energymadeeasy.gov.au/agl/cds-au/v1/energy/plans/AGL1067320MRE2@EME and header x-v 3, HTTP 200.

AER Energy Product Reference Data - Get Generic Plan Detail 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, Tariffs, and Electricity. 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.

23 operations 18 paths 64 schemas 18 GET5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.36.0
Base URL
https://cdr.energymadeeasy.gov.au/agl/cds-au/v1
Resource Areas
7

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 Plans 2

Energy Plan endpoints

GET
/energy/plans
Get Generic Plans
listEnergyPlans 9 params → 200400406422
GET
/energy/plans/{planId}
Get Generic Plan Detail
getEnergyPlanDetail 3 params → 200400404406
Electricity Service Points 2

Electricity Service Point endpoints

GET
/energy/electricity/servicepoints
Get Service Points
listElectricityServicePoints 8 params → 200400406422
GET
/energy/electricity/servicepoints/{servicePointId}
Get Service Point Detail
getElectricityServicePointDetail 7 params → 200400404406
Electricity Usage 3

Electricity Usage endpoints

GET
/energy/electricity/servicepoints/{servicePointId}/usage
Get Usage For Service Point
getElectricityServicePointUsage 12 params → 200400404406422
GET
/energy/electricity/servicepoints/usage
Get Bulk Usage
listElectricityUsageBulk 11 params → 200400406422
POST
/energy/electricity/servicepoints/usage
Get Usage For Specific Service Points
listElectricityUsageForServicePoints 11 params body → 200400406422
Distributed Energy Resources 3

Distributed Energy Resource endpoints

GET
/energy/electricity/servicepoints/{servicePointId}/der
Get DER For Service Point
getElectricityDERForServicePoint 7 params → 200400404406
GET
/energy/electricity/servicepoints/der
Get Bulk DER
listElectricityDERBulk 8 params → 200400406422
POST
/energy/electricity/servicepoints/der
Get DER For Specific Service Points
listElectricityDERForSpecificServicePoints 8 params body → 200400406422
Energy Accounts 4

Energy Account endpoints

GET
/energy/accounts
Get Energy Accounts
listEnergyAccounts 9 params → 200400406422
GET
/energy/accounts/{accountId}
Get Energy Account Detail
getEnergyAccountDetail 7 params → 200400404406
GET
/energy/accounts/{accountId}/payment-schedule
Get Agreed Payment Schedule
getEnergyAccountPaymentSchedule 7 params → 200400404406
GET
/energy/accounts/{accountId}/concessions
Get Concessions
getEnergyAccountConcessions 7 params → 200400404406
Energy Account Balances 3

Energy Account Balance endpoints

GET
/energy/accounts/{accountId}/balance
Get Balance For Energy Account
getEnergyAccountBalance 7 params → 200400404406
GET
/energy/accounts/balances
Get Bulk Balances for Energy
listEnergyAccountBalancesBulk 8 params → 200400406422
POST
/energy/accounts/balances
Get Balances For Specific Energy Accounts
listEnergyAccountBalancesSpecificAccounts 8 params body → 200400406422
Energy Account Billing 6

Energy Account Billing endpoints

GET
/energy/accounts/{accountId}/invoices
Get Invoices For Account
getEnergyAccountInvoices 11 params → 200400404406422
GET
/energy/accounts/invoices
Get Bulk Invoices
listEnergyAccountInvoicesBulk 10 params → 200400406422
POST
/energy/accounts/invoices
Get Invoices For Specific Accounts
listEnergyInvoicesForSpecificAccounts 10 params body → 200400406422
GET
/energy/accounts/{accountId}/billing
Get Billing For Account
getBillingForEnergyAccount 11 params → 200400404406422
GET
/energy/accounts/billing
Get Bulk Billing
listEnergyAccountBillingBulk 10 params → 200400406422
POST
/energy/accounts/billing
Get Billing For Specific Accounts
listEnergyAccountBillingForSpecificAccounts 10 params body → 200400406422

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.

EnergyPlanListResponse
object
3 properties 3 required
EnergyPlanResponseV3
object
3 properties 2 required
EnergyServicePointListResponseV2
object
3 properties 3 required
EnergyServicePointDetailResponseV2
object
3 properties 2 required
EnergyUsageListResponse
object
3 properties 3 required
EnergyDerListResponse
object
3 properties 3 required
EnergyDerDetailResponse
object
3 properties 2 required
EnergyAccountListResponseV2
object
3 properties 3 required
EnergyAccountDetailResponseV4
object
3 properties 2 required
EnergyPaymentScheduleResponse
object
3 properties 2 required
EnergyConcessionsResponse
object
3 properties 2 required
EnergyBalanceListResponse
object
3 properties 3 required
EnergyBalanceResponse
object
3 properties 2 required
EnergyInvoiceListResponse
object
3 properties 3 required
EnergyBillingListResponseV3
object
3 properties 3 required
PrimaryResponseErrorListV1
object
1 property 1 required
PrimaryErrorV1
object
ResponseErrorListV2
object
1 property 1 required
ErrorV2
object
4 properties 3 required
EnergyPlan
object
14 properties 6 required
EnergyPlanDetailV3
EnergyPlanContractV3
object
16 properties 4 required
EnergyPlanContractFullV3
EnergyPlanControlledLoadV2
object
6 properties 2 required
EnergyPlanIncentives
object
4 properties 3 required
EnergyPlanDiscounts
object
10 properties 3 required
EnergyPlanGreenPowerCharges
object
5 properties 4 required
EnergyPlanEligibility
object
3 properties 2 required
EnergyPlanFees
object
5 properties 2 required
EnergyPlanSolarFeedInTariffV3
object
9 properties 4 required
EnergyPlanTariffPeriodV2
object
12 properties 4 required
EnergyDaysEnum
string
EnergyServicePointV2
object
10 properties 7 required
EnergyServicePointDetailV2
EnergyUsageRead
object
11 properties 4 required
EnergyDerRecord
object
8 properties 6 required
EnergyAccountBaseV2
object
5 properties 1 required
EnergyAccountV2
EnergyAccountDetailV4
EnergyPaymentSchedule
object
6 properties 1 required
EnergyConcession
object
10 properties 2 required
EnergyInvoice
object
14 properties 6 required
EnergyInvoiceGasUsageCharges
object
6 properties 4 required
EnergyInvoiceElectricityUsageCharges
object
6 properties 4 required
EnergyInvoiceAccountCharges
object
Object contains account level charges and credits related to electricity usage.
3 properties 2 required
EnergyBillingTransactionV3
object
9 properties 3 required
EnergyBillingUsageTransactionV2
object
12 properties 5 required
EnergyBillingDemandTransactionV3
object
12 properties 5 required
MeasureUnitEnum
string
EnergyBillingOnceOffTransaction
object
4 properties 2 required
EnergyBillingOtherTransaction
object
9 properties 2 required
EnergyBillingPaymentTransaction
object
2 properties 2 required
CommonPhysicalAddress
object
3 properties 1 required
CommonSimpleAddress
object
Required if addressUType is set to simple.
8 properties 3 required
CommonPAFAddress
object
Australian address formatted according to the file format defined by the [PAF file format](https://auspost.com.au/content/dam/auspostcorp/media/documents/austr…
22 properties 3 required
RequestServicePointIdListV1
object
2 properties 1 required
RequestAccountIdListV1
object
2 properties 1 required
EnergyPlanId
string
The unique identifier for the Energy plan.
EnergyServicePointId
string
A unique identifier for an Energy service point, generated according to [CDR ID Permanence](id-permanence) requirements.
EnergyAccountId
string
A unique identifier for an Energy account, generated according to [CDR ID Permanence](id-permanence) requirements.
Links
object
1 property 1 required
Meta
object
LinksPaginated
object
5 properties 1 required
MetaPaginated
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cdr-energy-api-openapi.json Raw ↑

Other APIs Australian Energy Regulator publishes across the network.

AER Energy Product Reference Data - Get Generic Plans
AER CDR Discovery - Get Status and Get Outages
Where this information came from

This is an independent, third-party profile of AER Energy Product Reference Data - Get Generic Plan Detail, 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.