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.19' 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: 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