Octopus Energy

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.

3 APIs 18 Features

EnergyElectricityGasRenewable EnergySmart MeterTariffsKrakenUKDERElectric VehiclesHeat PumpsSolarBattery

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-p...

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 t...

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

Collections

Octopus Energy Public API

OPEN

GraphQL

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

GRAPHQL

Pricing Plans

Octopus Energy Plans Pricing

2 plans

PLANS

Rate Limits

Octopus Energy Rate Limits

3 limits

RATE LIMITS

FinOps

Octopus Energy Finops

FINOPS

Features

Public REST API at api.octopus.energy/v1/ — open product catalog, electricity/gas tariffs, meter points, half-hourly consumption, and industry grid supply points

HTTP Basic authentication with a per-customer API key for account, meter-point, and consumption endpoints; products and tariffs endpoints are open and unauthenticated

Half-hourly Agile Octopus and 30-minute Octopus Tracker pricing endpoints for wholesale-linked smart tariffs that publish 16-48 hours of forward unit rates

Industry grid supply points lookup so consumers can resolve the correct distribution region from a postcode

JSON request/response over HTTPS with cursor-style pagination on collection endpoints

Half-hourly smart-meter consumption pulls for electricity (MPAN + serial number) and gas (MPRN + serial number)

Kraken developer portal at developer.octopus.energy with REST API Reference generated from an OpenAPI specification

Kraken developer portal GraphQL API at /v1/graphql/ with introspection, API Collections, and a public changelog

API Collections that group GraphQL queries and mutations by feature — accounts, ledgers, billing, smart meters, half-hourly consumption, EV charging, heat pumps, batteries, Octopus Electroverse

Intelligent Octopus dispatch schedules exposed via GraphQL for partners to read EV-charging and heat-pump optimization windows

Public conventions repository documenting Octopus Energy's internal Python and Django style guide

xocto open-source Python/Django utility library from Kraken Technologies — typed money, ranges, settlement periods, and event sourcing primitives

oejp-api-example reference application showing how to consume the Octopus Energy Japan API

octotools Python utilities for the UK energy market — DNO/GSP lookups and tariff parsing helpers

Kraken Technologies SaaS platform powering 90M+ customer accounts across EDF, E.ON, Origin Energy, Tokyo Gas, Plentitude, Severn Trent, National Grid, and other partners in 30 countries

Kraken product suites — Customer Management, Residential Flexibility, Field Operations, Infrastructure Flexibility — covering retail energy, water, and telecom utilities

Domain coverage for electricity and gas retail, electric vehicles via Octopus Electroverse, heat pumps via Cosy Octopus, solar, batteries, and tariff-aware smart device control

UK-first API surface with parallel Octopus Energy Japan, Australia, New Zealand, Germany, France, Italy, Spain, and United States deployments via the same Kraken platform

GitHubOrganization

Sources

opencollection: 1.0.0
info:
  name: Octopus Energy Public API
  version: '1.0'
request:
  auth:
    type: basic
    username: '{{username}}'
    password: '{{password}}'
items:
- info:
    name: Products
    type: folder
  items:
  - info:
      name: List Products
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/
      params:
      - name: page
        value: ''
        type: query
      - name: page_size
        value: ''
        type: query
      - name: is_variable
        value: ''
        type: query
      - name: is_green
        value: ''
        type: query
      - name: is_tracker
        value: ''
        type: query
      - name: is_prepay
        value: ''
        type: query
      - name: is_business
        value: ''
        type: query
      - name: available_at
        value: ''
        type: query
        description: ISO 8601 timestamp filtering products available at that moment.
      - name: brand
        value: ''
        type: query
    docs: List Octopus Energy products. Filter by availability, business type, variant, and brand.
  - info:
      name: Retrieve a Product
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariffs_active_at
        value: ''
        type: query
    docs: Retrieve a single product including its electricity and gas tariffs by region.
- info:
    name: ElectricityTariffs
    type: folder
  items:
  - info:
      name: List Electricity Standard Unit Rates
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/electricity-tariffs/:tariff_code/standard-unit-rates/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
      - name: page
        value: ''
        type: query
      - name: page_size
        value: ''
        type: query
    docs: Half-hourly or daily standard unit rates for an electricity tariff such as Agile Octopus or Octopus Tracker.
  - info:
      name: List Electricity Standing Charges
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/electricity-tariffs/:tariff_code/standing-charges/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
      - name: page
        value: ''
        type: query
      - name: page_size
        value: ''
        type: query
    docs: List Electricity Standing Charges
  - info:
      name: List Electricity Day Unit Rates
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/electricity-tariffs/:tariff_code/day-unit-rates/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
    docs: List Electricity Day Unit Rates
  - info:
      name: List Electricity Night Unit Rates
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/electricity-tariffs/:tariff_code/night-unit-rates/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
    docs: List Electricity Night Unit Rates
- info:
    name: GasTariffs
    type: folder
  items:
  - info:
      name: List Gas Standard Unit Rates
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/gas-tariffs/:tariff_code/standard-unit-rates/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
    docs: List Gas Standard Unit Rates
  - info:
      name: List Gas Standing Charges
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/products/:product_code/gas-tariffs/:tariff_code/standing-charges/
      params:
      - name: product_code
        value: ''
        type: path
        description: Product code, for example AGILE-24-10-01 or VAR-22-11-01.
      - name: tariff_code
        value: ''
        type: path
        description: Tariff code, for example E-1R-AGILE-24-10-01-A.
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
    docs: List Gas Standing Charges
- info:
    name: ElectricityMeterPoints
    type: folder
  items:
  - info:
      name: Retrieve an Electricity Meter Point
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/electricity-meter-points/:mpan/
      params:
      - name: mpan
        value: ''
        type: path
        description: Meter Point Administration Number for electricity (13 digits).
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: Retrieve information about an electricity meter point including the GSP region and registered meters.
- info:
    name: Consumption
    type: folder
  items:
  - info:
      name: List Electricity Consumption
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/electricity-meter-points/:mpan/meters/:serial_number/consumption/
      params:
      - name: mpan
        value: ''
        type: path
        description: Meter Point Administration Number for electricity (13 digits).
      - name: serial_number
        value: ''
        type: path
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
      - name: order_by
        value: ''
        type: query
      - name: group_by
        value: ''
        type: query
      - name: page
        value: ''
        type: query
      - name: page_size
        value: ''
        type: query
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: List half-hourly smart-meter electricity consumption readings for the given meter.
  - info:
      name: List Gas Consumption
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/gas-meter-points/:mprn/meters/:serial_number/consumption/
      params:
      - name: mprn
        value: ''
        type: path
        description: Meter Point Reference Number for gas.
      - name: serial_number
        value: ''
        type: path
      - name: period_from
        value: ''
        type: query
        description: ISO 8601 inclusive start of the period.
      - name: period_to
        value: ''
        type: query
        description: ISO 8601 exclusive end of the period.
      - name: group_by
        value: ''
        type: query
      - name: page
        value: ''
        type: query
      - name: page_size
        value: ''
        type: query
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: List Gas Consumption
- info:
    name: GasMeterPoints
    type: folder
  items:
  - info:
      name: Retrieve a Gas Meter Point
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/gas-meter-points/:mprn/
      params:
      - name: mprn
        value: ''
        type: path
        description: Meter Point Reference Number for gas.
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: Retrieve a Gas Meter Point
- info:
    name: Industry
    type: folder
  items:
  - info:
      name: List Grid Supply Points
      type: http
    http:
      method: GET
      url: https://api.octopus.energy/v1/industry/grid-supply-points/
      params:
      - name: postcode
        value: ''
        type: query
    docs: List UK grid supply points and resolve the GSP for a postcode.
bundled: true

Octopus Energy

APIs

Octopus Energy Public API

Octopus Energy Kraken REST API

Octopus Energy Kraken GraphQL API

Collections

Octopus Energy Public API

GraphQL

Octopus Energy GraphQL API

Pricing Plans

Octopus Energy Plans Pricing

Rate Limits

Octopus Energy Rate Limits

FinOps

Octopus Energy Finops

Features

Semantic Vocabularies

Octopus Energy Context

API Governance Rules

Octopus Energy API Rules

Example Payloads

Octopus Energy List Electricity Consumption Example

Octopus Energy List Electricity Standard Unit Rates Example

Octopus Energy List Products Example

Resources

Sources