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-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
  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
  - url: graphql/octopus-energy-graphql.md
    type: GraphQL
  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.
- aid: octopus-energy:octopus-energy-consumption-api
  name: Octopus Energy Consumption API
  description: Half-hourly smart-meter consumption readings.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - Consumption
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-consumption-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-electricitymeterpoints-api
  name: Octopus Energy ElectricityMeterPoints API
  description: Electricity meter points (MPAN) and registered meters.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - ElectricityMeterPoints
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-electricitymeterpoints-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-electricitytariffs-api
  name: Octopus Energy ElectricityTariffs API
  description: Electricity tariff unit rates and standing charges.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - ElectricityTariffs
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-electricitytariffs-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-gasmeterpoints-api
  name: Octopus Energy GasMeterPoints API
  description: Gas meter points (MPRN) and registered meters.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - GasMeterPoints
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-gasmeterpoints-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-gastariffs-api
  name: Octopus Energy GasTariffs API
  description: Gas tariff unit rates and standing charges.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - GasTariffs
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-gastariffs-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-industry-api
  name: Octopus Energy Industry API
  description: UK industry references such as grid supply points.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - Industry
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-industry-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
- aid: octopus-energy:octopus-energy-products-api
  name: Octopus Energy Products API
  description: Octopus Energy product catalog and tariff lookups.
  humanURL: https://developer.octopus.energy/docs/api/
  baseURL: https://api.octopus.energy/v1/
  tags:
  - Products
  properties:
  - type: OpenAPI
    url: openapi/octopus-energy-products-api-openapi.yml
  - type: Documentation
    url: https://developer.octopus.energy/docs/api/
  - type: GettingStarted
    url: https://developer.octopus.energy/rest/guides/api-basics
  - type: JSONSchema
    url: json-schema/octopus-energy-product-schema.json
  - type: JSONSchema
    url: json-schema/octopus-energy-consumption-schema.json
  - type: JSONLD
    url: json-ld/octopus-energy-context.jsonld
name: Octopus Energy
tags:
- Energy
- Electricity
- Gas
- Renewable Energy
- Smart Meter
- Tariffs
- Kraken
- UK
- DER
- Electric Vehicles
- Heat Pumps
- Solar
- Battery
kind: contract
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/octopus-energy.png
access: 3rd-Party
common:
- type: AgenticAccess
  url: agentic-access/octopus-energy-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/octopus-energy-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/octopus-energy-domain-security.yml
- type: Authentication
  url: authentication/octopus-energy-authentication.yml
- 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: Tools
- url: https://github.com/octoenergy/xocto
  name: xocto - Python/Django Utilities from Kraken Technologies
  type: SDKs
- 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: Tools
- 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: Tools
- url: https://github.com/octoenergy/terraform-provider-splitpolicies
  name: Terraform Provider for Split Policies
  type: Tools
- 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: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'