Good Energy

aid: good-energy
url: https://raw.githubusercontent.com/api-evangelist/good-energy/refs/heads/main/apis.yml
name: Good Energy
kind: company
description: 'Good Energy is a British renewable energy supplier and green-technology installer founded in 1999 and headquartered
  in Chippenham, Wiltshire, acquired outright by Abu Dhabi based Esyasoft Investment Holding in March 2025 for GBP 99.4 million.
  It sits on the retail edge of the GB electricity value chain: a licensed supplier buying 100% renewable power directly from
  more than 2,000 British generators, the largest voluntary administrator of the Feed-in Tariff, an export/Smart Export Guarantee
  counterparty, and an installer of solar, batteries, heat pumps and EV chargers. Its API posture is honest and thin. The
  United Kingdom mandated smart-metering INFRASTRUCTURE, not a consumer data right: Good Energy is a Balancing and Settlement
  Code and Retail Energy Code party operating DCC-adopted SMETS2 smart meters — verified through an Ofgem regulatory-sandbox
  decision naming Good Energy Ltd and through Elexon BSC modification P459, which Good Energy itself raised to allow different
  supplier agents on import and export MSIDs where DCC-adopted smart meters are installed. That obligation produces no public
  API whatsoever. There is no UK equivalent of the Australian Consumer Data Right binding Good Energy, no Green Button, and
  no accredited-recipient scheme. No developer portal exists (developer., developers., docs. and data. subdomains do not resolve;
  /developers, /api and /docs return 404). Both sides are closed: consumer usage and billing data are reachable only by the
  account holder through the login-gated customer hub, and no open grid or market data is published — GB open energy data
  comes from NESO, Elexon and the DNOs, not from the supplier. The single machine-readable API artifact Good Energy exposes
  anonymously is the OpenID Connect discovery document of its customer-login identity provider.'
image: https://www.goodenergy.co.uk/wp-content/uploads/2021/11/cropped-good-energy-favicon-192x192.png
tags:
- Energy
- United Kingdom
- Utilities
- Electricity
- Gas
- Renewables
- Smart Metering
- Solar
- EV Charging
- Energy Retail
created: '2026-07-27'
modified: '2026-07-27'
specificationVersion: '0.23'
apis:
- aid: good-energy:good-energy-customer-identity-openid-connect
  name: Good Energy Customer Identity (OpenID Connect)
  description: The OpenID Connect / OAuth 2.0 identity provider behind Good Energy's customer hub at account.goodenergy.co.uk.
    It is NOT a developer-facing API and Good Energy publishes no documentation for it — it is listed here only because its
    discovery metadata is served anonymously and machine-readably at https://login.goodenergy.co.uk/.well-known/openid-configuration
    (HTTP 200, application/json, fetched 2026-07-27), making it the only harvestable API contract the company exposes. The
    document advertises a Duende IdentityServer style surface with authorization, token, userinfo, introspection, revocation,
    device-authorization, CIBA and PAR endpoints, PKCE (S256), DPoP signing algorithms, and the scopes openid, profile, email,
    offline_access, customer_portal and customer_portal_tariff_switch. There is no registration_endpoint, so no third party
    can obtain a client; access is customer-account-required.
  humanURL: https://account.goodenergy.co.uk/
  baseURL: https://login.goodenergy.co.uk
  tags:
  - Energy
  - United Kingdom
  - Identity
  - OpenID Connect
  - Authentication
  - Customer Portal
  tags_raw:
  - Energy
  - United Kingdom
  - Identity
  - OpenID Connect
  - OAuth
  - Customer Portal
  properties:
  - type: OpenIDConnectDiscovery
    url: authentication/good-energy-openid-configuration.json
  - type: JWKS
    url: authentication/good-energy-openid-jwks.json
  - type: Authentication
    url: authentication/good-energy-authentication.yml
  - type: OpenIDConnect
    url: https://login.goodenergy.co.uk/.well-known/openid-configuration
  - type: OAuthScopes
    url: scopes/good-energy-scopes.yml
  - type: SignIn
    url: https://account.goodenergy.co.uk/
common:
- type: VulnerabilityDisclosure
  url: security/good-energy-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/good-energy-domain-security.yml
- type: Website
  url: https://www.goodenergy.co.uk/
- type: Blog
  url: https://www.goodenergy.co.uk/blog/
- type: BlogRSS
  url: https://www.goodenergy.co.uk/feed/
- type: LinkedIn
  url: https://uk.linkedin.com/company/goodenergyuk
- type: SignIn
  url: https://account.goodenergy.co.uk/
- type: SecurityTxt
  url: well-known/good-energy-security.txt
- type: Security
  url: https://www.goodenergy.co.uk/.well-known/security.txt
- type: WellKnown
  url: well-known/good-energy-well-known.yml
- type: Authentication
  url: authentication/good-energy-authentication.yml
- type: OAuthScopes
  url: scopes/good-energy-scopes.yml
- type: Conformance
  url: conformance/good-energy-conformance.yml
- type: LLMsTxt
  url: llms/good-energy-llms.txt
- type: Pricing
  url: https://www.goodenergy.co.uk/good-energy-tariffs/
- type: SignUp
  url: https://www.goodenergy.co.uk/join/
- type: TermsOfService
  url: https://www.goodenergy.co.uk/terms-conditions/
- type: PrivacyPolicy
  url: https://www.goodenergy.co.uk/privacy-policy/
- type: Partners
  url: https://www.goodenergy.co.uk/partners/
- type: InvestorRelations
  url: https://www.goodenergy.co.uk/investors/
- type: Support
  url: https://www.goodenergy.co.uk/help/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com