aid: aer url: https://raw.githubusercontent.com/api-evangelist/aer/refs/heads/main/apis.yml name: Australian Energy Regulator kind: company description: >- The Australian Energy Regulator (AER) is the independent national economic regulator of Australia's energy markets, established under the Competition and Consumer Act 2010 and operating alongside the ACCC. It sets network revenues and prices, enforces the National Electricity, Gas and Energy Retail Rules, monitors wholesale and retail market conduct, sets the Default Market Offer, keeps the public registers of authorised retailers and exemptions, and operates Energy Made Easy, the government price-comparison service. Its API posture is the strongest found among Australian energy regulators and it is genuinely implemented rather than merely mandated. The AER is a designated data holder under the Competition and Consumer (Consumer Data Right) Rules 2020 and it serves the Consumer Data Standards energy Product Reference Data endpoints — Get Generic Plans and Get Generic Plan Detail — anonymously, with no accreditation, no API key and no signup, returning live retail plan, tariff, fee, discount and eligibility data for the six jurisdictions that adopted the National Energy Customer Framework. Verified on 2026-07-27, 79 of the 84 energy data-holder brands in the ACCC CDR Register point their productBaseUri at the AER's own host, cdr.energymadeeasy.gov.au, which makes the regulator the actual operator of the product-data API layer for nearly the whole Australian retail energy industry. The split matters: the AER's open surface is product and tariff data only. It holds and exposes no individual consumer usage or billing data — the CDR consumer endpoints 404 on its host — because those flow from retailers as primary data holders and AEMO as the secondary data holder gateway, behind ACCC accreditation, OAuth2/OIDC and mTLS. The AER's own market statistics, wholesale performance reporting and public registers are published as web pages, charts and document downloads, not as an API, and no developer., developers., api., docs. or data. subdomain resolves. image: https://www.aer.gov.au/sites/default/files/2023-08/logo-2x.png tags: - Energy - Australia - Utilities - Electricity - Gas - Energy Markets - Consumer Data Right - Retail Energy - Regulation - Government - Open Data - Smart Metering created: '2026-07-27' modified: '2026-07-27' specificationVersion: '0.19' apis: - aid: aer:aer-energy-product-reference-data-get-generic-plans name: AER Energy Product Reference Data - Get Generic Plans description: 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. humanURL: https://www.aer.gov.au/energy-product-reference-data baseURL: https://cdr.energymadeeasy.gov.au/agl/cds-au/v1 tags: - Energy - Consumer Data Right - Product Reference Data - Electricity - Gas - Tariffs properties: - type: Documentation url: https://www.aer.gov.au/energy-product-reference-data - type: APIReference url: https://consumerdatastandardsaustralia.github.io/standards/index.html#get-generic-plans - type: OpenAPI url: openapi/cdr-energy-api-openapi.json - type: Specification url: https://consumerdatastandardsaustralia.github.io/standards/ - type: Documentation url: https://www.aer.gov.au/documents/consumer-data-right-energy-retailer-base-uris-and-cdr-brands - type: Documentation url: https://www.aer.gov.au/documents/fact-sheet-accessing-energy-product-reference-data - type: Registry url: https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary - aid: aer:aer-energy-product-reference-data-get-generic-plan-detail name: AER Energy Product Reference Data - Get Generic Plan Detail description: 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. humanURL: https://www.aer.gov.au/energy-product-reference-data baseURL: https://cdr.energymadeeasy.gov.au/agl/cds-au/v1 tags: - Energy - Consumer Data Right - Product Reference Data - Tariffs - Electricity - Gas properties: - type: Documentation url: https://www.aer.gov.au/energy-product-reference-data - type: APIReference url: https://consumerdatastandardsaustralia.github.io/standards/#cdr-energy-api_get-generic-plan-detail - type: OpenAPI url: openapi/cdr-energy-api-openapi.json - type: Specification url: https://consumerdatastandardsaustralia.github.io/standards/ - type: Documentation url: https://www.aer.gov.au/documents/consumer-data-right-energy-retailer-base-uris-and-cdr-brands - aid: aer:aer-cdr-discovery-status-and-outages name: AER CDR Discovery - Get Status and Get Outages description: Anonymous Consumer Data Standards Common API discovery endpoints served by the AER on its CDR host. GET /discovery/status returns the current operational status of the data holder's CDR endpoints and GET /discovery/outages returns scheduled and current outages. Verified 2026-07-27 - status returned HTTP 200 with data.status OK and an updateTime, outages returned HTTP 200 with an empty outages array, both with header x-v 1 (x-v 2 returns 406). This is the AER's status page - there is no HTML status site - and it is the correct surface to poll before raising a support ticket against the product reference data endpoints. Both endpoints are brand-scoped and must be called under a retailer path segment; the unbranded /cds-au/v1/discovery/status returns 404. Observed quirk - the outages response links.self echoed a different brand path than the one requested. humanURL: https://www.aer.gov.au/energy-product-reference-data baseURL: https://cdr.energymadeeasy.gov.au/agl/cds-au/v1 tags: - Energy - Consumer Data Right - Status - Outages - Discovery properties: - type: OpenAPI url: openapi/cds-common-api-openapi.json - type: StatusPage url: https://cdr.energymadeeasy.gov.au/agl/cds-au/v1/discovery/status - type: APIReference url: https://consumerdatastandardsaustralia.github.io/standards/#common-apis - type: Documentation url: https://www.aer.gov.au/energy-product-reference-data - type: Overlay url: overlays/aer-cds-common-api-overlay.yaml common: - type: DomainSecurity url: security/aer-domain-security.yml - type: Website url: https://www.aer.gov.au/ - type: About url: https://www.aer.gov.au/about - type: Contact url: https://www.aer.gov.au/about/contact-us - type: Documentation url: https://www.aer.gov.au/energy-product-reference-data - type: APIReference url: https://consumerdatastandardsaustralia.github.io/standards/ - type: Registers url: https://www.aer.gov.au/industry/registers - type: Registers url: https://www.aer.gov.au/industry/registers/authorisations - type: DataPortal url: https://www.aer.gov.au/industry/registers/charts - type: Reports url: https://www.aer.gov.au/industry/wholesale/performance - type: Website url: https://www.energymadeeasy.gov.au/ - type: Blog url: https://www.aer.gov.au/news - type: RSS url: https://www.aer.gov.au/rss.xml - type: Regulation url: https://www.cdr.gov.au/ - type: GettingStarted url: https://www.aer.gov.au/documents/fact-sheet-accessing-energy-product-reference-data - type: Support url: https://www.aer.gov.au/about/contact-us - type: PrivacyPolicy url: https://www.aer.gov.au/about/policies/privacy - type: TermsOfService url: https://www.aer.gov.au/about/policies/disclaimer-copyright - type: Accessibility url: https://www.aer.gov.au/about/policies/accessibility - type: LinkedIn url: https://www.linkedin.com/company/aergovau/ - type: StatusPage url: https://cdr.energymadeeasy.gov.au/agl/cds-au/v1/discovery/status - type: Deprecation url: https://consumerdatastandardsaustralia.github.io/standards/includes/endpoint-version-schedule/index.html - type: Security url: https://www.aer.gov.au/.well-known/security.txt - type: SecurityTxt url: well-known/aer-security.txt - type: WellKnown url: well-known/aer-well-known.yml - type: VulnerabilityDisclosure url: security/aer-vulnerability-disclosure.yml - type: Authentication url: authentication/aer-authentication.yml - type: Conventions url: conventions/aer-conventions.yml - type: ErrorCatalog url: errors/aer-problem-types.yml - type: Lifecycle url: lifecycle/aer-lifecycle.yml - type: RateLimits url: rate-limits/aer-rate-limits.yml - type: Conformance url: conformance/aer-conformance.yml - type: Compliance url: conformance/aer-conformance.yml - type: ChangeLog url: changelog/aer-changelog.yml - type: DataModel url: data-model/aer-data-model.yml - type: MCPServer url: mcp/aer-mcp.yml - type: ToolCrosswalk url: mcp/aer-tool-crosswalk.yml - type: LLMsTxt url: llms/aer-llms.txt - type: Overlay url: overlays/aer-cdr-energy-api-overlay.yaml - type: Overlay url: overlays/aer-cds-common-api-overlay.yaml - type: AgentSkill url: skills/_index.yml - type: OpenAPI url: openapi/cds-common-api-openapi.json maintainers: - FN: Kin Lane email: kin@apievangelist.com