aid: simply-energy
url: https://raw.githubusercontent.com/api-evangelist/simply-energy/refs/heads/main/apis.yml
name: Simply Energy
kind: company
description: Simply Energy is the former brand of the Australian electricity and gas retailer
  that now trades as ENGIE, operated by IPower Pty Ltd (ACN 111 267 228) and IPower 2 Pty
  Ltd (ABN 24 070 374 293) trading as ENGIE (ABN 67 269 241 237), together with Simply Energy
  Solutions Pty Ltd. The business carried the Simply Energy name for seventeen years before
  rebranding to ENGIE in April 2024, and supplies more than 700,000 residential and business
  accounts across Victoria, South Australia, New South Wales, Queensland and Western Australia.
  It sits on the retail tier of the National Electricity Market value chain, buying wholesale
  energy and billing end customers, rather than in generation, transmission or distribution.
  Its API posture is entirely a product of statutory mandate, and in this case the mandate
  is genuinely implemented rather than merely claimed. The company is a designated Consumer
  Data Right energy data holder (data holder provider number DH002028) and is listed on the
  live CDR Register under the ENGIE brand. Its unauthenticated CDR Generic Plans endpoint,
  hosted for it by the Australian Energy Regulator's Energy Made Easy service, returns 2,452
  real ENGIE tariff plans conforming to the Consumer Data Standards energy schemas, and its
  own registered public base URI serves the Consumer Data Standards discovery endpoints with
  correct x-v version negotiation. Everything else is closed. Customer usage, billing, service
  point and DER data are available only to ACCC accredited data recipients with explicit consumer
  consent, there is no developer portal, no self-serve API keys, no published OpenID Connect
  discovery document, and no open grid, market or system data of any kind.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/groq.png
tags:
- Energy
- Australia
- Utilities
- Electricity
- Gas
- Energy Retail
- Consumer Data Right
- CDR
- Smart Metering
- Energy Markets
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.19'
apis:
- aid: simply-energy:simply-energy-cdr-energy-generic-plans-api
  name: Simply Energy (ENGIE) CDR Energy Generic Plans API
  description: Public, unauthenticated Consumer Data Right Generic Tariff Data for the Simply
    Energy / ENGIE retail brand, conforming to the Data Standards Body Consumer Data Standards
    energy schemas. Confirmed live on 2026-07-27. GET /energy/plans returns HTTP 200 with
    x-v 1 and meta.totalRecords 2452 ENGIE electricity and gas plans (MARKET and STANDING)
    across Ausgrid, Endeavour, Essential Energy, Energex, SA Power Networks, Jemena and AGN
    distribution zones. GET /energy/plans/{planId} returns HTTP 200 at x-v 3. The endpoint
    is hosted on behalf of the retailer by the Australian Energy Regulator's Energy Made Easy
    service; it is not self-hosted.
  humanURL: https://engie.com.au/help-centre/cdr-policy
  baseURL: https://cdr.energymadeeasy.gov.au/engie/cds-au/v1
  tags:
  - Energy Plans
  - Generic Tariff Data
  - Consumer Data Right
  - Public
  properties:
  - type: OpenAPI
    url: openapi/simply-energy-cds-energy-openapi.yml
  - type: Overlay
    url: overlays/simply-energy-cds-energy-overlay.yaml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  - type: Documentation
    url: https://engie.com.au/help-centre/cdr-policy
  - type: AgentSkill
    name: Compare ENGIE retail energy plans
    url: skills/simply-energy-compare-energy-plans.md
- aid: simply-energy:simply-energy-cdr-discovery-api
  name: Simply Energy (ENGIE) CDR Discovery API
  description: The Consumer Data Standards Common Discovery API served from the brand's own
    registered CDR Public Base URI. Confirmed live on 2026-07-27. GET /discovery/status returns
    HTTP 200 at x-v 1 with status OK, and GET /discovery/outages returns HTTP 200 at x-v 1
    with an empty outages array. Both correctly reject x-v 2 and above with urn:au-cds:error:cds-all:Header/UnsupportedVersion.
    This host does NOT serve /energy/plans, it returns an nginx HTTP 404, which matches the
    behaviour of AGL, Alinta and Origin Energy and reflects the CDR energy design in which
    generic tariff data is centralised at the Australian Energy Regulator rather than held
    by each retailer.
  humanURL: https://engie.com.au/help-centre/cdr-policy
  baseURL: https://public.cdr.engie.com.au/cds-au/v1
  tags:
  - Discovery
  - Status
  - Outages
  - Consumer Data Right
  - Public
  properties:
  - type: OpenAPI
    url: openapi/simply-energy-cds-common-openapi.yml
  - type: Overlay
    url: overlays/simply-energy-cds-common-overlay.yaml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#common-apis
  - type: Documentation
    url: https://engie.com.au/help-centre/cdr-policy
  - type: StatusPage
    url: https://public.cdr.engie.com.au/cds-au/v1/discovery/status
  - type: AgentSkill
    name: Check ENGIE CDR data-holder health and outages
    url: skills/simply-energy-check-data-holder-health.md
- aid: simply-energy:simply-energy-cdr-energy-consumer-data-api
  name: Simply Energy (ENGIE) CDR Energy Consumer Data API
  description: The mandated Consumer Data Right consumer data sharing surface, covering energy
    accounts, balances, billing, invoices, concessions, payment schedules, electricity service
    points, usage and distributed energy resources, conforming to the shared Consumer Data
    Standards energy contract. NOT anonymously verifiable and deliberately listed without
    a base URL. The CDR InfoSec and resource base URIs for a data holder are published only
    through the authenticated portion of the CDR Register and are reachable only by an ACCC
    accredited data recipient presenting a client certificate. Access requires ACCC accreditation,
    OAuth2 / OpenID Connect under the CDR FAPI profile, mutual TLS, and explicit consumer
    consent. Recorded here as designated and documented, not as an endpoint confirmed by API
    Evangelist.
  humanURL: https://engie.com.au/help-centre/cdr-policy
  tags:
  - Energy Accounts
  - Usage
  - Billing
  - DER
  - Consumer Data Right
  - Accredited Only
  properties:
  - type: OpenAPI
    url: openapi/simply-energy-cds-energy-openapi.yml
  - type: Overlay
    url: overlays/simply-energy-cds-energy-overlay.yaml
  - type: APIReference
    url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
  - type: Documentation
    url: https://engie.com.au/help-centre/cdr-policy
  - type: OAuthScopes
    url: scopes/simply-energy-scopes.yml
  - type: AgentSkill
    name: Retrieve a consumer's ENGIE energy accounts, usage and billing
    url: skills/simply-energy-retrieve-consumer-energy-data.md
common:
- type: DomainSecurity
  url: security/simply-energy-domain-security.yml
- type: AgenticAccess
  url: agentic-access/simply-energy-agentic-access.yml
- type: Website
  url: https://www.simplyenergy.com.au/
- type: Website
  url: https://engie.com.au/
- type: Documentation
  url: https://engie.com.au/help-centre/cdr-policy
- type: APIReference
  url: https://consumerdatastandardsaustralia.github.io/standards/#energy-apis
- type: Registry
  url: https://api.cdr.gov.au/cdr-register/v1/energy/data-holders/brands/summary
- type: LinkedIn
  url: https://www.linkedin.com/company/engie-australia-new-zealand/
- type: HelpCenter
  url: https://engie.com.au/help-centre
- type: Blog
  url: https://engie.com.au/media-news
- type: PrivacyPolicy
  url: https://engie.com.au/help-centre/policies-and-commitments/privacy-policy
- type: TermsOfService
  url: https://engie.com.au/help-centre/policies-and-commitments/terms-of-use
- type: Authentication
  url: authentication/simply-energy-authentication.yml
- type: OAuthScopes
  url: scopes/simply-energy-scopes.yml
- type: Conventions
  url: conventions/simply-energy-conventions.yml
- type: ErrorCatalog
  url: errors/simply-energy-problem-types.yml
- type: RateLimits
  url: rate-limits/simply-energy-rate-limits.yml
- type: Lifecycle
  url: lifecycle/simply-energy-lifecycle.yml
- type: StatusPage
  url: https://public.cdr.engie.com.au/cds-au/v1/discovery/status
- type: Deprecation
  url: https://consumerdatastandardsaustralia.github.io/standards/#endpoint-version-schedule
- type: ChangeLog
  url: changelog/simply-energy-changelog.yml
- type: Conformance
  url: conformance/simply-energy-conformance.yml
- type: DataModel
  url: data-model/simply-energy-data-model.yml
- type: Packages
  url: packages/simply-energy-packages.yml
- type: WellKnown
  url: well-known/simply-energy-well-known.yml
- type: SecurityTxt
  url: well-known/simply-energy-engie-group-security.txt
- type: VulnerabilityDisclosure
  url: security/simply-energy-vulnerability-disclosure.yml
- type: Security
  url: https://www.engie.com/en/cert/
- type: LLMsTxt
  url: llms/simply-energy-llms.txt
- type: AgentSkill
  url: skills/_index.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com