Octopus Energy · GraphQL Specification

Octopus Energy 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.

Documentation Endpoint View on GitHub EnergyElectricityGasRenewable EnergySmart MeterTariffsKrakenUKDERElectric VehiclesHeat PumpsSolarBatteryGraphQL

Overview

Octopus Energy GraphQL API is a GraphQL API specification published by Octopus Energy on the APIs.io network.

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.

The GraphQL endpoint is available at https://api.octopus.energy/v1/graphql/. documentation is published at https://developer.octopus.energy/graphql/.

The specification includes 3 reference links.

Tagged areas include Energy, Electricity, Gas, Renewable Energy, and Smart Meter.

Endpoint

https://api.octopus.energy/v1/graphql/

References

Related API Specs

Octopus Energy Consumption API (OpenAPI) Octopus Energy ElectricityMeterPoints API (OpenAPI) Octopus Energy ElectricityTariffs API (OpenAPI) Octopus Energy GasMeterPoints API (OpenAPI) Octopus Energy GasTariffs API (OpenAPI) Octopus Energy Industry API (OpenAPI) Octopus Energy Products API (OpenAPI)
Back to Octopus Energy · All GraphQL Specs · GitHub

Work with this as data

Every GraphQL schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for graphql

4 MCP tools reach this
  • find_graphqlBrowse and filter every GraphQL schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This GraphQL schema
curl "https://apis.io/api/v1/graphql/octopus-energy-graphql"
All graphql
curl "https://apis.io/api/v1/graphql?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.