Australian Energy Regulator

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