Skip to content

Repository files navigation

Australian Energy Regulator (aer)

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.

APIs.json: https://raw.githubusercontent.com/api-evangelist/aer/refs/heads/main/apis.yml

Tags

  • Energy
  • Australia
  • Utilities
  • Electricity
  • Gas
  • Energy Markets
  • Consumer Data Right
  • Retail Energy
  • Regulation
  • Government
  • Open Data
  • Smart Metering

Timestamps

  • Created: 2026-07-27
  • Modified: 2026-07-27

APIs

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.

Tags

  • Energy
  • Consumer Data Right
  • Product Reference Data
  • Electricity
  • Gas
  • Tariffs

Properties

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.

Tags

  • Energy
  • Consumer Data Right
  • Product Reference Data
  • Tariffs
  • Electricity
  • Gas

Properties

Common Properties

Maintainers

Artifacts

Enrichment round 2026-07-27 (search → generate → derive; every claim probed live or cited):

  • openapi/ — CDR Energy API 1.36.0 and CDR Common API 1.36.0 (both DSB-authored, harvested verbatim)
  • overlays/ — what is true of the AER's deployment of those two specs (which operations are served, at which versions, on which real host)
  • authentication/ — the anonymous model plus the mandatory x-v / optional x-min-v header contract
  • conventions/ — base-URI shape, version negotiation, paging, envelope, tracing, CORS (no idempotency: the surface is read-only)
  • errors/ — the CDS urn:au-cds:error: catalogue, captured from live 400/404/406 responses
  • lifecycle/ — endpoint version schedule with real deprecation and retirement dates, CDS SLA, and the machine-readable status endpoint
  • rate-limits/ — the CDS Non-Functional Requirements the AER's own FAQ adopts (300 TPS public traffic, 1500ms/95%, 99.5% availability)
  • conformance/ — what the AER conforms to and, just as usefully, what it does not (no OAuth, no RFC 9457, no Green Button/IEEE 2030.5/CIM)
  • data-model/ — the plan entity graph derived from the specification's $ref tree
  • changelog/ — AER version notices plus DSB standards releases
  • well-known/ + security/ — RFC 9116 security.txt (contact only, no policy), TLS/DNS posture
  • mcp/ — a candidate tool surface and its crosswalk to real operationIds (the AER publishes no MCP server)
  • skills/, llms/ — generated agent operating instructions and an llms.txt (the AER publishes neither)

Notes

The specifications in openapi/ are the Data Standards Body's CDR Energy API 1.36.0 and CDR Common API 1.36.0, harvested verbatim from the Consumer Data Standards repository on 2026-07-27. It is the contract the AER serves, not a specification the AER publishes — the AER publishes none. The AER implements only the two /energy/plans operations from the energy spec, plus the two anonymous /discovery/status and /discovery/outages operations from the common spec — verified live on 2026-07-27, and the closest thing the AER has to a status page. The account, billing, service point, usage and distributed-energy-resource paths belong to retailers and AEMO and return 404 on the AER's host. See review.yml for the full mandate, access-gate and provenance record.

About

API Evangelist profile of aer — energy and utilities organization APIs.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors