Skip to content
BranchesTags

Repository files navigation

Octopus Energy (octopus-energy)

About this repository

This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.

Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema, apis.json, llms.txt and similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.

The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.

Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.

  • Something wrong? Open an issue on this repository, or email info@apievangelist.com.
  • Published something new? Ask for a re-score and we will re-run the rating.
  • Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.

Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.

Not from the company, and here with a question? You are welcome here — we would rather be the front line and point you the right way than have a good report go nowhere. What this repository can answer is narrow, though, so it is worth knowing who you are actually looking for:

  • A question about how the API works, an account, billing, or a bug in the service — that is the company's own support, not us. We profile this API; we do not operate it and cannot see your account.
  • A bug in an open-source project we only catalog — file it on that project's own repository. This has happened with a real and correct bug report that reached us instead of the people who could fix it, which helped nobody.
  • Anything about this listing itself — the description, the tags, the rating, a missing or wrong artifact — is ours. Open an issue here.
  • Not sure, or something general about API Evangelist or APIs.io — open an issue on the APIs.io Inbox and we will route it.

This repository contains no software, and we will never ask you to download anything. There is no build, release, installer, or binary here — only text and machine-readable API descriptions, so there is nothing here that can be "corrupt" or need "repairing". Any issue, comment, or email claiming otherwise and offering a download link is not from us and is hostile. Do not follow the link; it is a lure. Report it to GitHub and, if you like, tell us at info@apievangelist.com so we can take it down.

On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.

Full detail: Where this data comes from

Octopus Energy is a UK-founded retail energy supplier and the parent of Kraken Technologies, the AI-powered energy operating system that runs both Octopus and many of the world's largest utilities. Octopus operates a free, open REST API at api.octopus.energy/v1/ that exposes the full UK product catalog, electricity and gas tariff pricing (including the half-hourly wholesale-linked Agile Octopus and Tracker tariffs), meter-point details, half-hourly smart-meter consumption, and industry grid supply points. The Kraken developer portal at developer.octopus.energy adds a second REST surface generated from an OpenAPI spec plus a GraphQL API at /v1/graphql/ with API Collections grouping partner-facing queries and mutations for accounts, ledgers, billing, smart meters, EV charging, heat pumps, batteries, and Intelligent Octopus dispatch. Through Kraken Technologies the same platform powers 90M+ customer accounts at EDF, E.ON, Origin Energy, Tokyo Gas, Plentitude, National Grid, Severn Trent, and other utilities in 30 countries — making Octopus one of the most consequential open and programmable surfaces in retail energy.

APIs.json: https://raw.githubusercontent.com/api-evangelist/octopus-energy/refs/heads/main/apis.yml

Scope

  • Position: Consuming
  • Access: 3rd-Party

Tags

  • Energy
  • Electricity
  • Gas
  • Renewable Energy
  • Smart Meter
  • Tariffs
  • Kraken
  • UK
  • DER
  • Electric Vehicles
  • Heat Pumps
  • Solar
  • Battery

Timestamps

  • Created: 2026-05-25T00:00:00.000Z
  • Modified: 2026-05-25

APIs

Octopus Energy Public API

The Octopus Energy Public API is a free, JSON-over-HTTPS REST API exposing the company's full UK product catalog, electricity and gas tariff pricing, electricity and gas meter-point information, half-hourly smart-meter consumption data, and industry grid supply points. Customers authenticate with their own API key over HTTP Basic auth to access their meters and consumption; the products and tariffs surfaces are open and unauthenticated. The Agile Octopus and Octopus Tracker tariffs publish half-hourly and daily wholesale-linked unit rates that downstream automations consume to schedule EV charging, heat-pump heating, and battery dispatch.

Tags

  • Energy
  • Electricity
  • Gas
  • Tariffs
  • Meter Points
  • Consumption
  • Smart Meter
  • UK

Properties

Octopus Energy Kraken REST API

The Octopus Energy developer portal exposes a Kraken-backed REST API alongside the public GraphQL surface. The REST API is generated from an OpenAPI specification published in the developer portal Reference section, with API Collections that group endpoints by feature. Partners use the REST API for account onboarding, meter-point registration, consumption pulls, and tariff lookups against the Kraken energy operating system.

Tags

  • Energy
  • Kraken
  • Accounts
  • Meter Points
  • Consumption
  • Tariffs
  • Smart Meter
  • REST

Properties

Octopus Energy Kraken GraphQL API

The Octopus Energy GraphQL API is the primary Kraken interface for partner and customer-facing integrations. A single /v1/graphql/ endpoint exposes queries and mutations grouped into API Collections by feature — accounts, ledgers, billing, smart meters, half-hourly consumption, EV chargers, heat pumps, batteries, Intelligent Octopus dispatch schedules, and Octopus Electroverse devices. Kraken's GraphQL introspection plus a public changelog let third-party developers build smart-charging, demand-response, and home-energy-management apps directly against Kraken-powered utilities.

Tags

  • Energy
  • Kraken
  • GraphQL
  • Accounts
  • Meter Points
  • Smart Meter
  • Devices
  • Flexibility

Properties

Common Properties

Maintainers

FN: Kin Lane Email: info@apievangelist.com URL: https://apievangelist.com

About

Octopus Energy is a UK-founded retail energy supplier and the parent of Kraken Technologies, the AI-powered energy operating system that runs both Octopus and many of the world's largest utilities.

Topics

apis-jsonbatteryderelectric-vehicleselectricityenergygasheat-pumpskrakenrenewable-energysmart-metersolartariffsuk

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors