Energy API — Live

The data layer for UK regulated markets

ClauseHub standardises regulated disclosure data — Tariff Information Labels, Contract Summaries, Summary Boxes — across UK energy, telecoms, and banking. Three APIs, one uniform interface. Suppliers publish, consumers retrieve.

3
Regulated market APIs
3
Disclosure formats standardised
1
Uniform interface
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.

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

Integrate via REST API

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