# Energy Queensland

> Energy Queensland Limited is the Queensland Government-owned corporation that owns Energex and Ergon Energy Network (2.3 million electricity connections, distribution), Ergon Energy Retail (the notified-price retailer for ~760,000 regional Queensland customers), Yurika and SPARQ Solutions. It has no developer portal and publishes no API of its own. Every machine-readable surface recorded here exists because Part IVD of the Competition and Consumer Act 2010 designated the RETAIL subsidiary as a Consumer Data Right energy data holder. The distribution half was never designated and publishes nothing programmable.

Generated by API Evangelist (apievangelist.com) from https://github.com/api-evangelist/energy-queensland — method: generated, 2026-07-27. No provider-published llms.txt exists: /llms.txt was not reachable on any Energy Queensland host (the corporate sites return HTTP 403 to every programmatic client behind a Cloudflare challenge).

## What is actually callable

- [Get Generic Plans](https://cdr.energymadeeasy.gov.au/ergon/cds-au/v1/energy/plans): Anonymous. Send header `x-v: 1`. Returns Ergon Energy Retail's 36 REGULATED electricity plans for regional Queensland. Hosted by the Australian Energy Regulator's Energy Made Easy CDR host, not by Energy Queensland — in CDR energy (unlike CDR banking) generic plan data is served centrally per brand.
- [Get Generic Plan Detail](https://cdr.energymadeeasy.gov.au/ergon/cds-au/v1/energy/plans/ERG1064038RRE1@EME): Anonymous. Requires header `x-v: 3` (x-v 1 returns HTTP 406). Full tariff, supply charge, solar feed-in, discount and eligibility detail.
- [Get Status](https://public.cdr.ergonretail.com.au/cds-au/v1/discovery/status): Anonymous. `x-v: 1`. The only anonymous endpoint on an Energy-Queensland-controlled host. Returns OK / PARTIAL_FAILURE / SCHEDULED_OUTAGE / UNAVAILABLE.
- [Get Outages](https://public.cdr.ergonretail.com.au/cds-au/v1/discovery/outages): Anonymous. `x-v: 1`. Advertised CDR outages.

Everything else — energy accounts, balances, billing, invoices, concessions, payment schedules, electricity service points, interval usage and distributed energy resources (23 operations) — requires ACCC accreditation as a CDR data recipient, mutual TLS with CDR Register certificates, FAPI OAuth2/OIDC, and the individual customer's consent. There is no sandbox, no API key, no partner tier and no commercial path.

## APIs

- [Ergon Energy Retail CDR Energy Product Reference Data API](https://consumerdatastandardsaustralia.github.io/standards/#energy-apis): Anonymous generic plan data for the "ergon" brand.
- [Ergon Energy Retail CDR Discovery API](https://consumerdatastandardsaustralia.github.io/standards/#common-apis): Get Status and Get Outages on Ergon's registered CDR public base URI.
- [Ergon Energy Retail CDR Energy Consumer Data API](https://consumerdatastandardsaustralia.github.io/standards/#energy-apis): The consumer-authorised surface. Accredited data recipients only; the infosec base URI is published through the authenticated CDR Register.

## Specs

- [CDR Energy API OpenAPI 3.0.3 (v1.36.0)](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/openapi/energy-queensland-cds-energy-openapi.yml): The shared Data Standards Body contract Ergon implements. 23 operations. NOT an Energy Queensland publication.
- [CDR Common API OpenAPI 3.0.3 (v1.36.0)](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/openapi/energy-queensland-cds-common-openapi.yml): 4 operations — Get Customer, Get Customer Detail, Get Status, Get Outages.
- [Consumer Data Standards](https://consumerdatastandardsaustralia.github.io/standards/): The standard itself, maintained by the Treasury Data Standards Body.

## Runtime semantics

- [Conventions](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/conventions/energy-queensland-conventions.yml): x-v / x-min-v header versioning, x-fapi-interaction-id correlation (played back verbatim), page/page-size pagination with meta.totalRecords and links, no idempotency (read-only surface), no field expansion.
- [Error catalog](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/errors/energy-queensland-problem-types.yml): CDS error envelope `{"errors":[{code,title,detail}]}` with urn:au-cds:error:... codes. Not RFC 9457. Seven codes verified live.
- [Authentication](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/authentication/energy-queensland-authentication.yml): none for the public surface; FAPI 1.0 Advanced OAuth2 + OIDC over mTLS for everything else.
- [OAuth scopes](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/scopes/energy-queensland-scopes.yml): 11 CDR scopes, set centrally by the Data Standards Body.
- [Rate limits](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/rate-limits/energy-queensland-rate-limits.yml): CDR traffic thresholds — 300 TPS public, 10 TPS per customer, 50 TPS per data recipient software product.
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/lifecycle/energy-queensland-lifecycle.yml): 99.5% monthly availability obligation, dated endpoint version retirement schedule, machine-readable status endpoint.
- [Conformance](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/conformance/energy-queensland-conformance.yml): what it conforms to, and the energy standards (Green Button, IEEE 2030.5, OpenADR, IEC CIM, OCPP/OCPI) it does not.
- [Data model](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/data-model/energy-queensland-data-model.yml): EnergyPlan (public) and the consented Customer → EnergyAccount → ServicePoint → usage/DER/billing graph.
- [Agent skills](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/skills/_index.yml): packaged operating instructions grounded in real operationIds.

## What does not exist

- No developer portal, on any group domain. developer., developers., api., docs., data. and opendata. are NXDOMAIN on energyq.com.au, ergon.com.au and energex.com.au.
- No SDKs or client libraries on npm, PyPI, Maven Central, NuGet, pkg.go.dev, RubyGems, Packagist or crates.io.
- No CLI, no UI components, no Postman collection, no sandbox, no MCP server.
- No security.txt, no /.well-known document of any kind (all 404 on the CDR hosts, all 403 on the corporate sites).
- No AsyncAPI, no webhooks, no event or streaming surface.
- No open grid, network or market data API. Energex and Ergon Energy Network — 2.3 million connections — publish PDF planning reports, XLSX annexures, map viewers, and one open-licensed GIS dataset deposited on the Queensland Government's CKAN portal at data.qld.gov.au (which is a third party's API, not theirs).
- No published security certification (no SOC 2, ISO 27001, PCI DSS) and no trust centre.

## Reference

- [Company profile (apis.yml)](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/apis.yml)
- [API Evangelist review](https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/review.yml)
- [CDR Register energy data holder brands](https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary): Ergon Energy Retail, dataHolderBrandId 3a732abd-b2e1-ee11-a73d-6045bd4001ae, ABN 11121177802.
- [ACCC exemption register entry](https://www.accc.gov.au/public-registers/exemption-for-ergon-energy-queensland-pty-ltd): s56GD exemption of 25 August 2023 deferring certain CDR obligations to 1 July 2024.
- [Energy Queensland GitHub organisation](https://github.com/Energy-Queensland): two public repositories, both forks of third-party AEMO tooling.