Octopus Energy

aid: octopus-energy
url: https://raw.githubusercontent.com/api-evangelist/octopus-energy/refs/heads/main/apis.yml
apis:
- aid: octopus-energy:octopus-energy-public-api
  name: Octopus Energy Public API
  tags:
  - Energy
  - Electricity
  - Gas
  - Tariffs
  - Meter Points
  - Consumption
  - Smart Meter
  - UK
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  properties:
  - url: https://developer.octopus.energy/docs/api/
    type: Documentation
  - url: https://developer.octopus.energy/rest/guides/api-basics
    type: GettingStarted
  - url: openapi/octopus-energy-public-api-openapi.yml
    type: OpenAPI
  - url: json-schema/octopus-energy-product-schema.json
    type: JSONSchema
  - url: json-schema/octopus-energy-consumption-schema.json
    type: JSONSchema
  - url: json-ld/octopus-energy-context.jsonld
    type: JSONLD
  - type: NaftikoCapability
    url: capabilities/products-catalog.yaml
  - type: NaftikoCapability
    url: capabilities/electricity-tariffs.yaml
  - type: NaftikoCapability
    url: capabilities/gas-tariffs.yaml
  - type: NaftikoCapability
    url: capabilities/electricity-meter-points.yaml
  - type: NaftikoCapability
    url: capabilities/gas-meter-points.yaml
  - type: NaftikoCapability
    url: capabilities/consumption-readings.yaml
  - type: NaftikoCapability
    url: capabilities/grid-supply-points.yaml
  description: 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.
- aid: octopus-energy:octopus-energy-kraken-rest-api
  name: Octopus Energy Kraken REST API
  tags:
  - Energy
  - Kraken
  - Accounts
  - Meter Points
  - Consumption
  - Tariffs
  - Smart Meter
  - REST
  humanURL: https://developer.octopus.energy/rest/
  properties:
  - url: https://developer.octopus.energy/rest/
    type: Documentation
  - url: https://developer.octopus.energy/rest/reference
    type: Documentation
  - url: https://developer.octopus.energy/rest/guides
    type: GettingStarted
  - url: https://developer.octopus.energy/rest/guides/authentication
    type: Authentication
  - type: NaftikoCapability
    url: capabilities/kraken-accounts.yaml
  - type: NaftikoCapability
    url: capabilities/kraken-meter-points.yaml
  description: 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.
- aid: octopus-energy:octopus-energy-kraken-graphql-api
  name: Octopus Energy Kraken GraphQL API
  tags:
  - Energy
  - Kraken
  - GraphQL
  - Accounts
  - Meter Points
  - Smart Meter
  - Devices
  - Flexibility
  humanURL: https://developer.octopus.energy/graphql/
  baseURL: https://api.octopus.energy/v1/graphql/
  properties:
  - url: https://developer.octopus.energy/graphql/
    type: Documentation
  - url: https://developer.octopus.energy/graphql/reference
    type: Documentation
  - url: https://developer.octopus.energy/graphql/guides
    type: GettingStarted
  - url: https://developer.octopus.energy/graphql/collections/
    type: Documentation
  - url: https://developer.octopus.energy/graphql/guides/authentication
    type: Authentication
  - url: https://developer.octopus.energy/announcements/
    type: ChangeLog
  - type: NaftikoCapability
    url: capabilities/graphql-accounts.yaml
  - type: NaftikoCapability
    url: capabilities/graphql-devices.yaml
  - type: NaftikoCapability
    url: capabilities/graphql-flexibility.yaml
  description: 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.
name: Octopus Energy
tags:
- Energy
- Electricity
- Gas
- Renewable Energy
- Smart Meter
- Tariffs
- Kraken
- UK
- DER
- Electric Vehicles
- Heat Pumps
- Solar
- Battery
kind: contract
image: https://kinlane-productions2.s3.amazonaws.com/apis-json/apis-json-logo.jpg
access: 3rd-Party
common:
- url: https://octopus.energy
  type: Portal
- url: https://developer.octopus.energy/
  name: Octopus Energy Developer Portal
  type: Portal
- url: https://developer.octopus.energy/docs/api/
  name: Octopus Energy Public API Docs
  type: Documentation
- url: https://developer.octopus.energy/rest/
  name: Kraken REST API Docs
  type: Documentation
- url: https://developer.octopus.energy/graphql/
  name: Kraken GraphQL API Docs
  type: Documentation
- url: https://developer.octopus.energy/announcements/
  name: API Announcements
  type: ChangeLog
- url: https://developer.octopus.energy/auth/login/
  name: Developer Portal Login
  type: SignUp
- url: https://octopus.energy/dashboard/
  name: My Octopus Account
  type: SignUp
- url: https://octopus.energy/help-and-faqs/articles/api-information/
  name: API Information FAQ
  type: Support
- url: https://octopus.energy/help-and-faqs/articles/security-at-octopus-energy/
  name: Security at Octopus Energy
  type: Security
- url: https://octopus.energy/policies/
  name: Policies
  type: Documentation
- url: https://octopus.energy/privacy/
  name: Privacy Policy
  type: PrivacyPolicy
- url: https://octopus.energy/blog/
  name: Octopus Energy Blog
  type: Blog
- url: https://octopus.energy/press/
  name: Press
  type: Press
- url: https://octopus.energy/careers/
  name: Careers
  type: Careers
- url: https://octopus.energy/about-us/
  name: About Us
  type: AboutUs
- url: https://octopus.energy/contact-us/
  name: Contact Us
  type: ContactUs
- url: https://kraken.tech/
  name: Kraken Technologies
  type: Portal
- url: https://kraken.tech/news
  name: Kraken News
  type: Blog
- url: https://kraken.tech/customer-management
  name: Kraken Customer Management
  type: Documentation
- url: https://kraken.tech/residential-flexibility
  name: Kraken Residential Flexibility
  type: Documentation
- url: https://kraken.tech/field-operations
  name: Kraken Field Operations
  type: Documentation
- url: https://kraken.tech/infrastructure-flexibility
  name: Kraken Infrastructure Flexibility
  type: Documentation
- url: https://octopus.energy/agile/
  name: Octopus Agile
  type: Documentation
- url: https://octopus.energy/smart/tracker/
  name: Octopus Tracker
  type: Documentation
- url: https://octopus.energy/smart/intelligent-octopus-go/
  name: Intelligent Octopus Go
  type: Documentation
- url: https://octopus.energy/electric-vehicles/electroverse/
  name: Octopus Electroverse
  type: Documentation
- url: https://octopus.energy/heat-pumps/
  name: Cosy Octopus (Heat Pumps)
  type: Documentation
- url: https://octopusev.com/
  name: Octopus Electric Vehicles
  type: Documentation
- url: https://github.com/octoenergy
  type: GitHubOrganization
- url: https://github.com/octoenergy/public-conventions
  name: Octopus Energy Public Conventions
  type: Tool
- url: https://github.com/octoenergy/xocto
  name: xocto - Python/Django Utilities from Kraken Technologies
  type: SDK
- url: https://github.com/octoenergy/oejp-api-example
  name: Octopus Energy Japan API Example
  type: CodeExamples
- url: https://github.com/octoenergy/octotools
  name: octotools - UK Energy Market Utilities
  type: Tool
- url: https://github.com/octoenergy/techzero-hackathon-2024
  name: Tech Zero Hackathon 2024
  type: CodeExamples
- url: https://github.com/octoenergy/timeserio
  name: timeserio - Time Series Models
  type: Tool
- url: https://github.com/octoenergy/terraform-provider-splitpolicies
  name: Terraform Provider for Split Policies
  type: Tool
- url: https://www.linkedin.com/company/octopus-energy
  type: LinkedIn
- url: https://www.linkedin.com/company/krakentech
  name: Kraken Technologies LinkedIn
  type: LinkedIn
- url: https://twitter.com/octopus_energy
  type: Twitter
- url: https://www.youtube.com/@OctopusEnergy
  type: YouTube
- url: plans/octopus-energy-plans-pricing.yml
  type: Plans
- url: rate-limits/octopus-energy-rate-limits.yml
  type: RateLimits
- url: finops/octopus-energy-finops.yml
  type: FinOps
- type: Features
  data:
  - 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
  sources:
  - https://developer.octopus.energy/
  - https://developer.octopus.energy/docs/api/
  - https://developer.octopus.energy/rest/
  - https://developer.octopus.energy/graphql/
  - https://octopus.energy/help-and-faqs/articles/api-information/
  - https://kraken.tech/
  - https://github.com/octoenergy
  updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Consuming
description: 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.
maintainers:
- FN: Kin Lane
  email: [email protected]
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'