Amber Electric

aid: amber-electric
url: https://raw.githubusercontent.com/api-evangelist/amber-electric/refs/heads/main/apis.yml
name: Amber Electric
kind: company
description: 'Amber Electric is an Australian electricity retailer (ABN 98623603805) that sells wholesale National Electricity
  Market pricing straight through to residential customers on a flat monthly membership, rather than marking energy up, and
  automates home batteries, solar exports and EV charging against those half-hourly prices. It sits at the retail end of the
  Australian energy value chain, between AEMO''s wholesale market and the household meter. Its API posture is unusually honest
  and unusually split. Amber publishes a real, verbatim OpenAPI 3.0.0 contract for a REST API at https://api.amber.com.au/v1
  covering sites, prices, forecasts and usage, but the token that unlocks it is generated inside the logged-in customer app
  at https://app.amber.com.au/developers, so the API is customer-account-required rather than self-serve — a developer who
  is not an Amber customer cannot obtain a key. One endpoint is the exception: the spec explicitly declares `security: []`
  on GET /state/{state}/renewables/current, and that grid renewables-percentage feed really does answer anonymously for NSW,
  VIC, QLD and SA, so open market data and gated consumer data live inside the same contract. Separately, Amber is a designated
  Consumer Data Right energy data holder that is genuinely live, not merely designated: it is listed on the ACCC CDR Register
  with a working public base URI at https://public.cdr.amber.com.au, whose CDS discovery endpoints and anonymously-served
  OpenID Connect configuration advertise the full Consumer Data Standards energy scope set behind private_key_jwt and CDR
  accreditation.'
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/amber-electric.png
tags:
- Energy
- Australia
- Electricity
- Utilities
- Consumer Data Right
- Energy Markets
- Renewables
- Solar
- Batteries
- DER
- Smart Metering
- Wholesale Pricing
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: amber-electric:amber-electric-public-api
  name: Amber Electric Public API
  description: 'Amber Electric''s own documented REST API, described by a verbatim OpenAPI 3.0.0 contract the company publishes
    in its public GitHub repository. Five read-only operations: list the sites on your account, fetch actual, current and
    forecast half-hourly prices for a site, fetch usage for a site, and read the current renewables percentage for a National
    Electricity Market state. Authentication is HTTP bearer (declared in the spec as the `apiKey` security scheme, type http
    / scheme bearer) and the token is generated from the Developers tab inside the logged-in Amber customer app, so four of
    the five operations require an active Amber account. The renewables operation carries an explicit `security: []` override
    and was confirmed to return 200 anonymously on 2026-07-27.'
  humanURL: https://app.amber.com.au/developers
  baseURL: https://api.amber.com.au/v1
  tags:
  - Energy
  - Electricity
  - Pricing
  - Usage
  - Renewables
  - Australia
  properties:
  - type: OpenAPI
    url: openapi/amber-electric-public-api-openapi.json
  - type: Documentation
    url: https://app.amber.com.au/developers
  - type: APIReference
    url: https://app.amber.com.au/developers/documentation
  - type: SourceCode
    url: https://github.com/amberelectric/public-api
  - type: Support
    url: https://github.com/amberelectric/public-api/discussions
- aid: amber-electric:amber-electric-cdr-energy-api
  name: Amber Electric Consumer Data Right Energy API
  description: 'Amber''s Consumer Data Right energy data-holder surface, mandated by the Australian CDR regime extended from
    banking into energy and administered by the ACCC with standards set by the Data Standards Body. Amber is listed on the
    public CDR Register as an energy data holder brand (dataHolderBrandId 54968899-b7b5-ef11-95f6-6045bd3f1493, ABN 98623603805,
    lastUpdated 2026-07-23) with the public base URI https://public.cdr.amber.com.au. The implementation was verified live
    on 2026-07-27, not merely claimed: the Consumer Data Standards discovery endpoints /cds-au/v1/discovery/status and /cds-au/v1/discovery/outages
    both returned 200 with conformant CDS payloads, and /.well-known/openid-configuration is served anonymously. Access is
    accredited-only — dynamic client registration at https://secure.cdr.amber.com.au/connect/register with private_key_jwt
    client authentication and PAR, reachable only by an accredited CDR data recipient holding a software statement assertion
    from the CDR Register. No general developer can call it.'
  humanURL: https://www.cdr.gov.au/
  baseURL: https://public.cdr.amber.com.au/cds-au/v1
  tags:
  - Consumer Data Right
  - Energy
  - Open Data
  - Regulated
  - OpenID Connect
  - Australia
  properties:
  - type: Authentication
    url: authentication/amber-electric-cdr-openid-configuration.json
  - type: OpenIDConnectDiscovery
    url: https://public.cdr.amber.com.au/.well-known/openid-configuration
  - 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: Documentation
    url: https://www.cdr.gov.au/consumers/energy
  - type: OAuthScopes
    url: scopes/amber-electric-scopes.yml
common:
- type: IssueTracker
  url: https://github.com/amberelectric/public-api/issues
- type: License
  name: MIT
  url: https://github.com/amberelectric/public-api/blob/main/LICENSE
- type: AgenticAccess
  url: agentic-access/amber-electric-agentic-access.yml
- type: DomainSecurity
  url: security/amber-electric-domain-security.yml
- type: Authentication
  url: authentication/amber-electric-authentication.yml
- type: Packages
  url: packages/amber-electric-packages.yml
- type: SDKs
  url: packages/amber-electric-packages.yml
- type: WellKnown
  url: well-known/amber-electric-well-known.yml
- type: LLMsTxt
  url: llms/amber-electric-llms.txt
- type: MCPServer
  url: mcp/amber-electric-mcp.yml
- type: Overlay
  url: overlays/amber-electric-public-api-overlay.yaml
- type: Conformance
  url: conformance/amber-electric-conformance.yml
- type: ErrorCatalog
  url: errors/amber-electric-problem-types.yml
- type: Lifecycle
  url: lifecycle/amber-electric-lifecycle.yml
- type: Conventions
  url: conventions/amber-electric-conventions.yml
- type: RateLimits
  url: rate-limits/amber-electric-rate-limits.yml
- type: DataModel
  url: data-model/amber-electric-data-model.yml
- type: Examples
  url: examples/amber-electric-examples.yml
- type: OAuthScopes
  url: scopes/amber-electric-scopes.yml
- type: AgentSkill
  name: Read live grid renewables for an Australian state
  url: skills/amber-electric-grid-renewables.md
- type: AgentSkill
  name: Read current and forecast electricity prices for an Amber site
  url: skills/amber-electric-site-prices.md
- type: AgentSkill
  name: Pull interval usage and cost history for an Amber site
  url: skills/amber-electric-usage-history.md
- type: Website
  url: https://amber.com.au/
- type: DeveloperPortal
  url: https://app.amber.com.au/developers
- type: Documentation
  url: https://app.amber.com.au/developers
- type: APIReference
  url: https://app.amber.com.au/developers/documentation
- type: SourceCode
  url: https://github.com/amberelectric/public-api
- type: GitHubOrganization
  url: https://github.com/amberelectric
- type: Blog
  url: https://amber.com.au/blog
- type: Support
  url: https://help.amber.com.au/
- type: Community
  url: https://github.com/amberelectric/public-api/discussions
- type: Pricing
  url: https://amber.com.au/pricing
- type: TermsOfService
  url: https://amber.com.au/terms
- type: PrivacyPolicy
  url: https://amber.com.au/privacy
- type: SignUp
  url: https://app.amber.com.au/developers
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com