Red Energy

Red Energy Pty Ltd (ABN 60 107 479 372) is an Australian electricity and gas retailer, wholly owned by Snowy Hydro Ltd, that supplies more than a million residential and business customers across New South Wales, Victoria, Queensland, South Australia and the ACT from a Richmond, Victoria base. It sits on the retail end of the National Electricity Market value chain: Snowy Hydro generates, the distribution network businesses own the poles and wires, AEMO operates the market and holds metering data, and Red Energy owns the customer, the tariff and the bill. Its API posture is entirely a product of statute rather than product strategy. Red Energy publishes no developer portal, no self-serve API programme and no proprietary specification - developer., api., docs. and data. subdomains do not resolve, and redenergy.com.au itself sits behind a Cloudflare bot challenge that returns HTTP 403 to any non-browser client. What it does have is a real, verified Consumer Data Right implementation: it is a designated CDR energy data holder listed on the CDR Register with the public base URI https://public.cdr.redenergy.com.au, which serves the Consumer Data Standards discovery endpoints live with correct x-v version negotiation, while 1,705 Red Energy branded plans are published anonymously through the Australian Energy Regulator's Energy Made Easy CDR host. The split is the story - open, standardised, anonymous product reference data on one side, and consumer usage, billing and account data available only to accredited CDR data recipients with the customer's consent on the other, with nothing at all in between.

Red Energy publishes 3 APIs on the APIs.io network: CDR Energy Product Reference Data API, CDR Discovery API, and CDR Energy Consumer Data API. Tagged areas include Energy, Australia, Utilities, Electricity, and Gas.

Red Energy’s developer surface includes authentication, changelog, code examples, status page, documentation, API reference, support, and 29 more developer resources.

52.1/100 developing ▬ flat Agent 43/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
3 APIs 1 MCP Servers
EnergyAustraliaUtilitiesElectricityGasEnergy RetailConsumer Data RightCDRProduct Reference DataSmart MeteringOpen Data

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 52.1/100 · developing
Contract Quality 11.1 / 21
Developer Ergonomics 5.8 / 17
Commercial Clarity 8.9 / 17
Operational Transparency 8.4 / 11
Governance 2.1 / 10
Discoverability 6.1 / 9
Regulatory Posture 9.5 / 15
Agent readiness — 43/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Energy & Utilities regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/red-energy: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Red Energy CDR Energy Product Reference Data API

The unauthenticated Consumer Data Right Product Reference Data surface for the Red Energy brand - Get Generic Plans and Get Generic Plan Detail from the Consumer Data Standards ...

Red Energy CDR Discovery API

Red Energy'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 -...

Red Energy CDR Energy Consumer Data API

The consumer-authorised half of the Consumer Data Right energy obligation that Red Energy is designated to meet as a data holder - electricity service points, usage, distributed...

Open Collections 2

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

CDR Common API

OPEN COLLECTION

CDR Energy API

OPEN COLLECTION

Arazzo Workflows 1

Multi-step API workflows described with the Arazzo specification.

Compare Red Energy tariff plans

Check that Red Energy's CDR implementation is available, then list its published electricity plans and pull the full tariff detail for one of them. Every step is unauthenticated...

ARAZZO

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Rate Limits 1

Documented rate limits and quota policies.

Red Energy Rate Limits

15 limits

RATE LIMITS

Examples 7

Example request and response payloads for these APIs.

Scroll for all 7

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Red Energy Authentication

none/oauth2/openIdConnect/mutualTLS · 4 schemes

SECURITY

Red Energy Domain Security

TLSv1.3 · HSTS · DNSSEC · DMARC

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Red Energy Scopes

11 scopes · authorizationCode

11 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Red Energy Agentic Access

27 operations

27 operations · 0 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 6

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 4

Authentication, authorization, and security posture

Operate 8

Status, limits, changes, and where to get help

Scroll for all 8

Commercial 3

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Other 1

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: red-energy
url: https://raw.githubusercontent.com/api-evangelist/red-energy/refs/heads/main/apis.yml
name: Red Energy
kind: company
description: 'Red Energy Pty Ltd (ABN 60 107 479 372) is an Australian electricity and gas retailer, wholly owned by Snowy
  Hydro Ltd, that supplies more than a million residential and business customers across New South Wales, Victoria, Queensland,
  South Australia and the ACT from a Richmond, Victoria base. It sits on the retail end of the National Electricity Market
  value chain: Snowy Hydro generates, the distribution network businesses own the poles and wires, AEMO operates the market
  and holds metering data, and Red Energy owns the customer, the tariff and the bill. Its API posture is entirely a product
  of statute rather than product strategy. Red Energy publishes no developer portal, no self-serve API programme and no proprietary
  specification - developer., api., docs. and data. subdomains do not resolve, and redenergy.com.au itself sits behind a Cloudflare
  bot challenge that returns HTTP 403 to any non-browser client. What it does have is a real, verified Consumer Data Right
  implementation: it is a designated CDR energy data holder listed on the CDR Register with the public base URI https://public.cdr.redenergy.com.au,
  which serves the Consumer Data Standards discovery endpoints live with correct x-v version negotiation, while 1,705 Red
  Energy branded plans are published anonymously through the Australian Energy Regulator''s Energy Made Easy CDR host. The
  split is the story - open, standardised, anonymous product reference data on one side, and consumer usage, billing and account
  data available only to accredited CDR data recipients with the customer''s consent on the other, with nothing at all in
  between.'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/red-energy.png
tags:
- Energy
- Australia
- Utilities
- Electricity
- Gas
- Energy Retail
- Consumer Data Right
- CDR
- Product Reference Data
- Smart Metering
- Open Data
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.19'
apis:
- aid: red-energy:red-energy-cdr-energy-product-reference-data-api
  name: Red Energy CDR Energy Product Reference Data API
  description: 'The unauthenticated Consumer Data Right Product Reference Data surface for the Red Energy brand - Get Generic
    Plans and Get Generic Plan Detail from the Consumer Data Standards CDR Energy API. Unlike CDR banking, where each authorised
    deposit-taking institution serves its own product endpoint, energy plan data is served centrally by the Australian Energy
    Regulator''s Energy Made Easy CDR host under a per-brand path. Confirmed live on 2026-07-27: GET /cds-au/v1/energy/plans
    with header x-v 1 returned HTTP 200 with response header x-v 1 and meta.totalRecords 1705 Red Energy plans across electricity
    and gas; the same call with no x-v header returned HTTP 400 and with x-v 9 returned HTTP 406, exactly the version-negotiation
    behaviour the Consumer Data Standards prescribe. Plan detail requires x-v 3 or higher - x-v 1 returns a urn:au-cds:error:cds-all:Header/UnsupportedVersion
    error. No API key, no signup and no accreditation is needed to call it.'
  humanURL: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  baseURL: https://cdr.energymadeeasy.gov.au/red-energy/cds-au/v1
  tags:
  - Energy Plans
  - Product Reference Data
  - Consumer Data Right
  - Tariffs
  - Australia
  properties:
  - type: OpenAPI
    url: openapi/red-energy-cds-energy-openapi.yml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#get-generic-plans
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#get-generic-plan-detail
  - type: Documentation
    url: https://consumerdatastandardsaustralia.github.io/standards/
  - type: Registry
    url: https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary
  - type: Overlay
    name: API Evangelist enhancements for the CDR Energy API
    url: overlays/red-energy-cds-energy-overlay.yaml
  - type: Examples
    name: Live list-plans capture, 2026-07-27
    url: examples/red-energy-list-energy-plans-example.json
  - type: Examples
    name: Live plan-detail capture, 2026-07-27
    url: examples/red-energy-get-energy-plan-detail-example.json
  - type: Arazzo
    name: Compare Red Energy tariff plans
    url: arazzo/red-energy-compare-plans-workflow.yml
  - type: AgentSkill
    name: Compare Red Energy tariff plans
    url: skills/red-energy-compare-energy-plans.md
- aid: red-energy:red-energy-cdr-discovery-api
  name: Red Energy CDR Discovery API
  description: 'Red Energy''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 API
    surface hosted on a Red Energy controlled domain. Confirmed live on 2026-07-27: GET /cds-au/v1/discovery/status with header
    x-v 1 returned HTTP 200 and a CDS-shaped envelope reporting status OK and "All services operational", GET /cds-au/v1/discovery/outages
    returned HTTP 200 with an empty outages array, the same calls without an x-v header returned HTTP 400, and x-v 3 returned
    HTTP 406. 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.'
  humanURL: https://consumerdatastandardsaustralia.github.io/standards/#common-apis
  baseURL: https://public.cdr.redenergy.com.au/cds-au/v1
  tags:
  - Discovery
  - Status
  - Outages
  - Consumer Data Right
  - Australia
  properties:
  - type: OpenAPI
    url: openapi/red-energy-cds-common-openapi.yml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#get-status
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#get-outages
  - type: Status
    url: https://public.cdr.redenergy.com.au/cds-au/v1/discovery/status
  - type: StatusPage
    url: https://public.cdr.redenergy.com.au/cds-au/v1/discovery/status
  - type: Documentation
    url: https://consumerdatastandardsaustralia.github.io/standards/
  - type: Overlay
    name: API Evangelist enhancements for the CDR Common API
    url: overlays/red-energy-cds-common-overlay.yaml
  - type: Examples
    name: Live get-status capture, 2026-07-27
    url: examples/red-energy-get-status-example.json
  - type: Examples
    name: Live get-outages capture, 2026-07-27
    url: examples/red-energy-get-outages-example.json
  - type: AgentSkill
    name: Check Red Energy CDR availability before calling
    url: skills/red-energy-check-cdr-availability.md
- aid: red-energy:red-energy-cdr-energy-consumer-data-api
  name: Red Energy CDR Energy Consumer Data API
  description: 'The consumer-authorised half of the Consumer Data Right energy obligation that Red Energy is designated to
    meet as a data holder - electricity service points, usage, distributed energy resources, energy accounts, balances, invoices,
    billing, concessions and payment schedules, sixteen paths in all from the Consumer Data Standards CDR Energy API. This
    surface is real and mandated, but it is not open: it is reachable only by an accredited CDR data recipient, over mutual
    TLS with FAPI-profile OAuth2 and OpenID Connect, after the individual customer grants consent, and the infosec base URI
    is published only through the authenticated portion of the CDR Register. No baseURL is recorded here because none is publicly
    discoverable, and no endpoint on this surface was called - it cannot be reached anonymously. The mandate is verified;
    the endpoints are, by design, unverifiable from outside the accreditation regime.'
  humanURL: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  tags:
  - Energy Accounts
  - Electricity Usage
  - Billing
  - Distributed Energy Resources
  - Consumer Data Right
  - Australia
  properties:
  - type: OpenAPI
    url: openapi/red-energy-cds-energy-openapi.yml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  - type: Authentication
    url: https://consumerdatastandardsaustralia.github.io/standards/#security-profile
  - type: Authentication
    name: Red Energy CDR authentication profile
    url: authentication/red-energy-authentication.yml
  - type: OAuthScopes
    name: CDR energy authorisation scopes
    url: scopes/red-energy-scopes.yml
  - type: Documentation
    url: https://consumerdatastandardsaustralia.github.io/standards/
  - type: Overlay
    name: API Evangelist enhancements for the CDR Energy API
    url: overlays/red-energy-cds-energy-overlay.yaml
  - type: AgentSkill
    name: Retrieve a consenting customer's energy data as an accredited data recipient
    url: skills/red-energy-share-consumer-energy-data.md
common:
- type: AgenticAccess
  url: agentic-access/red-energy-agentic-access.yml
- type: DomainSecurity
  url: security/red-energy-domain-security.yml
- type: Authentication
  name: Red Energy CDR authentication profile
  url: authentication/red-energy-authentication.yml
- type: OAuthScopes
  name: CDR energy authorisation scopes
  url: scopes/red-energy-scopes.yml
- type: Conventions
  name: Red Energy CDR API conventions
  url: conventions/red-energy-conventions.yml
- type: ErrorCatalog
  name: CDS error code catalogue
  url: errors/red-energy-problem-types.yml
- type: Lifecycle
  name: Red Energy CDR lifecycle, versioning and service levels
  url: lifecycle/red-energy-lifecycle.yml
- type: StatusPage
  name: CDR Get Status endpoint (machine-readable status surface)
  url: https://public.cdr.redenergy.com.au/cds-au/v1/discovery/status
- type: Deprecation
  name: CDS Endpoint Version Schedule (deprecation and retirement policy)
  url: https://consumerdatastandardsaustralia.github.io/standards/#endpoint-version-schedule
- type: Roadmap
  name: CDS Future Dated Obligations
  url: https://consumerdatastandardsaustralia.github.io/standards/#future-dated-obligations
- type: ChangeLog
  name: Consumer Data Standards changelog
  url: changelog/red-energy-changelog.yml
- type: RateLimits
  name: CDS traffic thresholds and velocity limits
  url: rate-limits/red-energy-rate-limits.yml
- type: Conformance
  name: Standards conformance, verified and asserted
  url: conformance/red-energy-conformance.yml
- type: Compliance
  name: Red Energy Consumer Data Right Policy
  url: https://www.redenergy.com.au/docs/Red-Energy-Consumer-Data-Right-Policy.pdf
- type: DataModel
  name: CDR energy entity graph
  url: data-model/red-energy-data-model.yml
- type: Packages
  name: Package registry search results and CDR ecosystem tooling
  url: packages/red-energy-packages.yml
- type: MCPServer
  name: Candidate MCP tool set derived from the CDR specs
  url: mcp/red-energy-mcp.yml
- type: ToolCrosswalk
  name: MCP tool to OpenAPI operation crosswalk
  url: mcp/red-energy-tool-crosswalk.yml
- type: AgentSkill
  name: Packaged agent skills for the Red Energy CDR surface
  url: skills/_index.yml
- type: Examples
  name: Live request/response captures, 2026-07-27
  url: examples/
- type: LLMsTxt
  name: Generated llms.txt
  url: llms/red-energy-llms.txt
- type: Arazzo
  name: Compare Red Energy tariff plans
  url: arazzo/red-energy-compare-plans-workflow.yml
- type: Website
  url: https://www.redenergy.com.au/
- type: LinkedIn
  url: https://www.linkedin.com/company/red-energy
- type: Status
  url: https://public.cdr.redenergy.com.au/cds-au/v1/discovery/status
- type: Registry
  url: https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary
- type: Documentation
  url: https://consumerdatastandardsaustralia.github.io/standards/
- type: APIReference
  url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
- type: Support
  name: Red Energy Contact Us
  url: https://www.redenergy.com.au/contactus/
- type: HelpCenter
  name: Red Energy Help Centre
  url: https://www.redenergy.com.au/help-centre/
- type: Pricing
  name: Red Energy energy plans
  url: https://www.redenergy.com.au/products/
- type: SignUp
  name: Red Energy MyAccount registration
  url: https://myaccount.redenergy.com.au/registration
- type: Login
  name: Red Energy MyAccount
  url: https://myaccount.redenergy.com.au/
- type: TermsOfService
  name: Red Energy Terms and Conditions
  url: https://www.redenergy.com.au/terms-and-conditions/
- type: PrivacyPolicy
  name: Red Energy Privacy Policy
  url: https://www.redenergy.com.au/privacy-policy/index.html
- type: Owner
  name: Snowy Hydro Ltd
  url: https://www.snowyhydro.com.au/retail/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com