# Ergon Energy Retail CDR Discovery API

**Canonical:** https://apis.io/apis/energy-queensland/ergon-energy-retail-cdr-discovery-api/  
**Provider:** Energy Queensland — https://apis.io/providers/energy-queensland/  
**Base URL:** https://public.cdr.ergonretail.com.au/cds-au/v1  
**Documentation:** https://consumerdatastandardsaustralia.github.io/standards/#common-apis

Ergon Energy Retail CDR Discovery API is one of 3 APIs that [Energy Queensland](https://apis.io/providers/energy-queensland/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Discovery, Status, Outages, Consumer Data Right, and Australia. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, a status page, and API documentation.

Ergon Energy Retail's own registered Consumer Data Right public base URI, serving the two unauthenticated Data Holder Operations endpoints of the Consumer Data Standards CDR Common API - Get Status and Get Outages. This is the only anonymously callable API surface hosted on an Energy Queensland controlled domain. Confirmed live 2026-07-27: GET /cds-au/v1/discovery/status with header x-v 1 returned HTTP 200 and the CDS envelope {"data":{"status":"OK","updateTime": "2026-07-27T12:08:30Z","explanation":"All services operational"},"links":{...},"meta":{}}, and GET /cds-au/v1/discovery/outages returned HTTP 200 with an empty outages array. The base URI serves nothing else anonymously - /cds-au/v1/energy/plans, the site root and /.well-known/openid-configuration all return an nginx HTTP 404.

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/openapi/energy-queensland-cds-common-openapi.yml
- **APIReference** — https://consumerdatastandardsaustralia.github.io/standards/#get-status
- **APIReference** — https://consumerdatastandardsaustralia.github.io/standards/#get-outages
- **Status** — https://public.cdr.ergonretail.com.au/cds-au/v1/discovery/status
- **Documentation** — https://consumerdatastandardsaustralia.github.io/standards/
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/overlays/energy-queensland-cds-common-overlay.yaml
- **AgentSkill** — https://raw.githubusercontent.com/api-evangelist/energy-queensland/refs/heads/main/skills/energy-queensland-check-cdr-availability.md

## Other Energy Queensland APIs (2)

- [Ergon Energy Retail CDR Energy Product Reference Data API](https://apis.io/apis/energy-queensland/ergon-energy-retail-cdr-energy-product-reference-data-api/)
- [Ergon Energy Retail CDR Energy Consumer Data API](https://apis.io/apis/energy-queensland/ergon-energy-retail-cdr-energy-consumer-data-api/)

## Tags

Discovery, Status, Outages, Consumer Data Right, Australia

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/energy-queensland/ergon-energy-retail-cdr-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/energy-queensland/.