Energy API — Live

Whole-of-market tariff data. One API call.

ClauseHub replaces bilateral data agreements with a single API. Energy suppliers publish tariffs, comparison sites retrieve them, regulators audit the history — all through one standardised JSON:API interface.

73+
UK energy suppliers covered
14
DNO regions mapped
47
API endpoints
200 OK
GET /v1/suppliers/{id}/tariffs
// application/vnd.api+json { "data": [{ "type": "tariffs", "id": "t_48f2a9b1", "attributes": { "name": "Flexible Oct 2025", "consumableRange": "Dual", "status": "active", "version": 3 } }], "links": { "self": "/suppliers/octopus/tariffs", "next": "/suppliers/octopus/tariffs?page[after]=..." } }
JSON:API v1.0

Tariff data flows through bespoke agreements

73+ energy suppliers, 11+ comparison sites, and countless bilateral data-sharing arrangements — each using a different format, each requiring a custom integration.

73+
Active domestic energy suppliers, each publishing tariff data in their own format — CSV over FTP, email, Excel spreadsheets, bespoke APIs.
N×M
Bilateral agreements needed. Every supplier must integrate individually with every comparison site. Administrative and technical overhead multiplies with each new participant.
0
Standardised, commission-free data APIs available for whole-of-market UK tariff data. Existing aggregators monetise via switching commissions, not data access.

From suppliers to consumers — one API

ClauseHub replaces bilateral data agreements with a single standardised intermediary.

Sources
British Gas
Dual fuel tariffs
Octopus Energy
Smart tariffs
E.ON Next
Fixed & variable
73+ suppliers
PUBLISH
ClauseHub API
JSON:API • REST • OpenAPI
Standardise Version Serve
CONSUME
Consumers
Aggregators
Compare the Market, Uswitch
AI Agents
LLM tool use, advisors
End Users
Developers, regulators

One interface, four types of consumer

ClauseHub sits between suppliers and every downstream consumer of contract data — comparison sites, regulators, fintechs, and AI agents.

Contract Suppliers

Energy retailers, telcos, and banks publish and manage their product data via a single API. Update once, distribute everywhere. Replace bilateral CSV and FTP exchanges with a standardised JSON:API interface.

Role: supplier — full CRUD on own data
British Gas Octopus Energy Vodafone EE Lloyds HSBC

Price Comparison Sites

Retrieve standardised tariff data for display to end users. Search by region, fuel type, payment method, or tariff type. No switching commission required.

Role: consumer — read-only access to all data
MoneySavingExpert Compare the Market Uswitch GoCompare

Regulators

Query live market prices and audit historical tariff changes. Immutable versioning means every update creates a new record — nothing is overwritten or deleted.

Role: consumer — read access + full version history
Ofgem FCA Ofcom PRA

AI Agents

Discover, search, and operate the API via tool use. Rich OpenAPI metadata, consistent JSON:API patterns, and a discovery endpoint at GET /schema for self-discovery.

Role: consumer — agentic workflows via tool use
LLM tool use Recommendation engines Automated advisors

A single intermediary replaces bilateral agreements

Suppliers publish once. Consumers query once. ClauseHub handles the standardisation, versioning, and distribution.

01

Suppliers Publish

Create and update tariffs via authenticated API endpoints. Each update creates an immutable version — no data is overwritten. Supports single and bulk operations (up to 100 items per request).

02

Data is Normalised

Tariffs are stored in a standardised schema: consumables (unit rates, standing charges), contract terms (fixed/variable, exit fees), regions (PES codes), and payment methods — all in JSON:API format.

03

Consumers Search & Retrieve

Search tariffs by type, fuel, payment method, or region. Retrieve recent changes with a timestamp filter. Cursor-based pagination via JSON:API links.next.

04

Every Change is Versioned

Immutable versioning across all resources. Updates insert new rows, deletes create archived versions. Full audit trail available via version endpoints — nothing is ever physically deleted.

Three products, three regulated disclosures

Each API standardises a different mandated disclosure format — Ofgem TILs, Ofcom Contract Summaries, and FCA Summary Boxes — into a uniform, machine-readable interface.

Live

Energy API

Standardises Ofgem Tariff Information Labels (TILs). Unit rates, standing charges, exit fees, contract terms, payment methods, and PES regions across 73+ domestic suppliers.

Disclosure: TIL (SLC 31) · Regulator: Ofgem
47 endpoints · 14 DNO regions · Bulk operations
Try it
Planned

Telecoms API

Standardises Ofcom Contract Summaries (General Condition C1). SIM-only plans, broadband, mobile bundles, mid-contract price rises, and early termination fees. National pricing — no regional variation.

Disclosure: Contract Summary · Regulator: Ofcom
~15 providers = ~90% market · Scraping complete
Try it
Planned

Banking API

Standardises FCA Summary Boxes (BCOBS 2 Annex 1R) and Fee Information Documents. Savings accounts, current accounts, cash ISAs, overdraft terms, and APR disclosures. Fills the gap Open Banking does not cover.

Disclosure: Summary Box / FID · Regulator: FCA
250+ banks & building societies · Schema designed
Try it
Energy
Telecoms
Banking

Why ClauseHub

A neutral, commission-free data intermediary designed from the ground up for UK regulated markets.

ClauseHub Bilateral Agreements Web Scraping
Standardised format JSON:API CSV, FTP, email Unstructured HTML
Commission-free Yes Often commission-based Yes
Audit trail Immutable versioning None None
Energy tariff data Full TIL coverage Per-agreement Fragile, incomplete
Integration effort One API N×M agreements Per-site scraper
Standard
JSON:API v1.0
Spec-compliant responses
Regulatory
Ofgem SLC 31
TIL data alignment
Security
JWT + RBAC
Role-based access control
Observability
99.9% Uptime
Sentry + Axiom + Checkly

Your first API call in 30 seconds

The public search endpoint requires no authentication. Copy this command and run it in your terminal.

curl
curl -s "https://api.clausehub.net/energy/tariffs/search/public" \
  -H "Accept: application/vnd.api+json" | python3 -m json.tool
Loading live results...
01
Copy the command
No API key needed for public search
02
Run in terminal
Returns real UK energy tariff data
03
Explore the data
JSON:API format with pagination
Search Playground Full Documentation

Integrate via REST API

Authentication uses Supabase JWT. Libraries available for Python and TypeScript. Full OpenAPI spec at GET /schema.