Consumer Data Right (Energy) · OpenAPI Overlay 1.0.0

API Evangelist enhancements for CDR Register API

11 actions 11 updates update extends openapi/cdr-register-openapi.json

Generated by API Evangelist Written by API Evangelist tooling for Consumer Data Right (Energy)'s API. It is a proposal applied on top of the contract, not a document Consumer Data Right (Energy) publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-accessx-apievangelist-access-notex-apievangelist-slugx-apievangelist-artifactsx-apievangelist-security-profilex-apievangelist-security-profile-notex-apievangelist-error-registryx-apievangelist-base-url-resolution

Targets 9

$.info

$.paths['/idp/.well-known/openid-configuration'].get

$.paths['/cdr-register/v1/jwks'].get

$.paths['/cdr-register/v1/{industry}/data-holders/brands'].get

$.paths['/cdr-register/v1/{industry}/data-holders/brands/summary'].get

$.paths['/cdr-register/v1/{industry}/data-holders/status'].get

$.paths['/cdr-register/v1/{industry}/data-recipients/brands/software-products/status'].get

$.paths['/cdr-register/v1/{industry}/data-recipients/status'].get

$.paths['/cdr-register/v1/{industry}/data-recipients'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: API Evangelist enhancements for CDR Register API
  version: 1.0.0
extends: openapi/cdr-register-openapi.json
x-generated: '2026-07-27'
x-method: generated
actions:
- target: $.info
  update:
    x-apievangelist-slug: cdr-energy
    x-apievangelist-artifacts:
      authentication: authentication/cdr-energy-authentication.yml
      scopes: scopes/cdr-energy-scopes.yml
      conventions: conventions/cdr-energy-conventions.yml
      errors: errors/cdr-energy-problem-types.yml
      lifecycle: lifecycle/cdr-energy-lifecycle.yml
      rate-limits: rate-limits/cdr-energy-rate-limits.yml
      conformance: conformance/cdr-energy-conformance.yml
      data-model: data-model/cdr-energy-data-model.yml
    x-apievangelist-security-profile: FAPI 1.0 Advanced; mutual TLS; private_key_jwt; PAR; PKCE S256
    x-apievangelist-security-profile-note: The Consumer Data Standards declare no components.securitySchemes
      in the OpenAPI documents; the security model is normative in a separate Security Profile section
      that all six APIs inherit.
    x-apievangelist-error-registry: urn:au-cds:error:* - ResponseErrorListV2 envelope, not RFC 9457
- target: $.info
  update:
    x-apievangelist-base-url-resolution:
      note: The servers[] entry in this document is a documentation placeholder (example.com). There is
        no single production base URL.
      discovery: https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary
      field: publicBaseUri
      path_suffix: /cds-au/v1
      registered_energy_brands: 84
      answered_anonymously_2026_07_27: 53
- target: $.info
  update:
    x-apievangelist-unauthenticated-operations:
    - getRegisterOpenIdProviderConfig
    - getRegisterJwks
    - getDataHolderBrands
    - getDataHolderBrandsSummary
    - getDataHolderStatuses
    - getSoftwareProductsStatuses
    - getDataRecipientsStatuses
    - getDataRecipients
- target: $.paths['/idp/.well-known/openid-configuration'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/jwks'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-holders/brands'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-holders/brands/summary'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-holders/status'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-recipients/brands/software-products/status'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-recipients/status'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.
- target: $.paths['/cdr-register/v1/{industry}/data-recipients'].get
  update:
    x-apievangelist-access: open
    x-apievangelist-access-note: No credential required. Verified with a live anonymous request on 2026-07-27.