Energy Queensland · OpenAPI Overlay 1.0.0

API Evangelist enhancements for the Ergon Energy Retail CDR Common API

6 actions 6 updates update extends openapi/energy-queensland-cds-common-openapi.yml

Derived by API Evangelist Built from the contracts Energy Queensland publishes. Energy Queensland did not publish this file.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-accessx-apievangelist-verifiedx-apievangelist-hostx-apievangelist-providerx-apievangelist-provider-slugx-apievangelist-data-holderx-apievangelist-spec-provenancex-apievangelist-role

Targets 6

$.info

$.servers

$.paths['/discovery/status'].get

$.paths['/discovery/outages'].get

$.paths['/common/customer'].get

$.paths['/common/customer/detail'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for the Ergon Energy Retail CDR Common API
  version: 1.0.0
extends: openapi/energy-queensland-cds-common-openapi.yml
x-apievangelist:
  generated: '2026-07-27'
  method: generated
  source: >-
    Live observations of Ergon Energy Retail's registered CDR public base URI on
    2026-07-27, applied over the shared DSB CDR Common API v1.36.0 document.
    The harvested specification itself is untouched.
actions:
  - target: $.info
    update:
      x-apievangelist-provider: Energy Queensland
      x-apievangelist-provider-slug: energy-queensland
      x-apievangelist-data-holder: Ergon Energy Retail (Ergon Energy Queensland Pty Ltd, ABN 11121177802)
      x-apievangelist-spec-provenance: >-
        Shared DSB Consumer Data Standards CDR Common API v1.36.0, harvested
        verbatim from
        https://consumerdatastandardsaustralia.github.io/standards/includes/swagger/cds_common.json.
        Not an Energy Queensland publication.
      x-apievangelist-verified: '2026-07-27'
  - target: $.servers
    description: Replace the standard's placeholder MTLS server with this brand's registered public base URI.
    update:
      - url: https://public.cdr.ergonretail.com.au/cds-au/v1
        description: >-
          Ergon Energy Retail's registered CDR publicBaseUri. Unauthenticated.
          Serves ONLY the two Data Holder Operations endpoints anonymously; the
          Data Holder Customers endpoints on this document are consent-gated and
          served from the mTLS resource host.
      - url: https://api.cdr.ergonretail.com.au/cds-au/v1
        description: Consumer data resource host. Mutual TLS, accredited data recipients only.
  - target: $.paths['/discovery/status'].get
    update:
      x-apievangelist-access: anonymous
      x-apievangelist-host: https://public.cdr.ergonretail.com.au/cds-au/v1
      x-apievangelist-role: >-
        This is the provider's entire status surface. There is no human status
        page anywhere on the Energy Queensland estate.
      x-apievangelist-verified: >-
        HTTP 200 on 2026-07-27 with x-v 1 - status OK, "All services
        operational". Response carries Strict-Transport-Security max-age
        63072000, X-Content-Type-Options nosniff and X-Frame-Options DENY.
  - target: $.paths['/discovery/outages'].get
    update:
      x-apievangelist-access: anonymous
      x-apievangelist-host: https://public.cdr.ergonretail.com.au/cds-au/v1
      x-apievangelist-verified: HTTP 200 on 2026-07-27 with x-v 1 and an empty outages array.
  - target: $.paths['/common/customer'].get
    update:
      x-apievangelist-access: accredited-only
      x-apievangelist-note: >-
        Not served on the public base URI. Every path other than the two
        discovery endpoints returns an nginx HTTP 404 there.
  - target: $.paths['/common/customer/detail'].get
    update:
      x-apievangelist-access: accredited-only

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/energy-queensland-cds-common-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.