{
  "dataset": "index",
  "generated": "2026-09-20T13:54:23.352Z",
  "licence": {
    "compilation": "CC BY 4.0",
    "compilation_url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Tariff Tracker, tarifftracker.io, published by PEF Consulting Partners Limited",
    "underlying": "The figures themselves belong to the bodies named in each dataset's sources. Most are Crown copyright under the Open Government Licence v3. Supplier tariff rates belong to the suppliers who publish them. Check the source terms before you rely on any of it commercially.",
    "corrections": "If a figure here is wrong, say so and we will correct it and record that we did."
  },
  "docs": "https://tarifftracker.io/api/",
  "fields": "https://tarifftracker.io/api/v1/dictionary",
  "service": "Tariff Tracker",
  "version": "v1",
  "what": "Every UK household price this site publishes, plus the trade tariff tracker, served as JSON or CSV. No key, no sign up, no rate limit beyond being reasonable.",
  "base": "https://tarifftracker.io/api/v1",
  "formats": [
    "json",
    "csv, by adding ?format=csv to any dataset that is a table"
  ],
  "freshness": {
    "site_data": "2026-08-26",
    "trade_data": "2026-08-26",
    "energy_tariffs": "2026-09-20T05:36:36.510Z",
    "energy_tariffs_note": null
  },
  "movement": {
    "tariffs_checked": 392,
    "tariffs_checked_at": "2026-09-20T05:36:36.510Z",
    "suppliers": 3,
    "regions": 14,
    "household_changes_logged_30d": 4,
    "changes_ahead": 22,
    "changes_ahead_confirmed": 13,
    "changes_ahead_date_only": 7,
    "changes_ahead_expected": 2,
    "trade_corridors": 29,
    "sources": 86
  },
  "datasets": [
    {
      "id": "benchmarks",
      "path": "/api/v1/benchmarks",
      "csv": true,
      "what": "What a typical UK household pays for each of the ten things this site tracks, with the source and the date each figure was set.",
      "updates": "When the underlying body publishes. Energy quarterly, water annually, the rest on their own timetable."
    },
    {
      "id": "prices",
      "path": "/api/v1/prices/{vertical}",
      "csv": false,
      "what": "Everything behind one vertical: the headline, the supporting figures, every reference table, the help schemes, the sources and the caveats.",
      "updates": "With the site."
    },
    {
      "id": "energy.tariffs",
      "path": "/api/v1/energy/tariffs",
      "csv": true,
      "what": "Every electricity and gas tariff we can verify, by region, from suppliers who publish their prices openly. Unit rate, standing charge, contract term, exit fee and the cost of a year at Ofgem's typical consumption.",
      "updates": "Nightly, direct from each supplier's own price endpoint."
    },
    {
      "id": "energy.cap",
      "path": "/api/v1/energy/cap",
      "csv": true,
      "what": "The Ofgem price cap unit rate and standing charge for electricity in each of the fourteen regions. This is what a default tariff charges, which is what you pay when a fix ends.",
      "updates": "Quarterly, when Ofgem sets the cap."
    },
    {
      "id": "changes",
      "path": "/api/v1/changes",
      "csv": true,
      "what": "What has already changed and when it took effect, across every bill the site tracks.",
      "updates": "As things change."
    },
    {
      "id": "upcoming",
      "path": "/api/v1/upcoming",
      "csv": true,
      "what": "Dated changes that have not happened yet, with a flag saying whether the amount is published or only the date.",
      "updates": "As dates are announced."
    },
    {
      "id": "lookup",
      "path": "/api/v1/lookup?postcode=",
      "csv": false,
      "what": "A postcode area turned into the things that decide your bills: electricity region, cap rates for that region, water company and its average bill.",
      "updates": "With the site."
    },
    {
      "id": "trade.corridors",
      "path": "/api/v1/trade/corridors",
      "csv": true,
      "what": "Twenty nine trade corridors, the duty going into the United States and the duty coming back the other way, layer by layer with effective dates.",
      "updates": "As measures are announced."
    },
    {
      "id": "trade.programmes",
      "path": "/api/v1/trade/programmes",
      "csv": true,
      "what": "The United States tariff programmes by legal authority, their rates, their scope and who is varied out of them.",
      "updates": "As measures are announced."
    },
    {
      "id": "trade.changes",
      "path": "/api/v1/trade/changes",
      "csv": true,
      "what": "The trade change log, including measures announced but not yet in force.",
      "updates": "As measures are announced."
    },
    {
      "id": "broadband.deals",
      "path": "/api/v1/broadband/deals",
      "csv": true,
      "what": "Broadband packages costed across the whole contract rather than on the advertised monthly price, with the April rises the provider has already published built in.",
      "updates": "With the site."
    },
    {
      "id": "energy.cap_history",
      "path": "/api/v1/energy/cap-history",
      "csv": true,
      "what": "The Ofgem price cap for every region and every quarter since it began in January 2019, for direct debit, standard credit and prepayment. Ofgem publishes the current cap but not this. It took a Freedom of Information request to get it out, and it is Ofgem's own figures under the Open Government Licence.",
      "updates": "Quarterly, when a new cap period starts."
    },
    {
      "id": "watch",
      "path": "/api/v1/watch",
      "csv": true,
      "what": "Every source this site cites, when it was last read, and when the figures on it last moved. Includes changes nobody has reviewed yet, because a reference site quietly going stale is worse than one that says where it might be behind.",
      "updates": "Every morning, a couple of sources at a time."
    },
    {
      "id": "support",
      "path": "/api/v1/support",
      "csv": true,
      "what": "Every grant, discount and protection for household bills, with the eligibility conditions as data rather than prose, which of the four nations it covers, the deadline, and where to apply.",
      "updates": "As schemes open, close and change."
    },
    {
      "id": "vouchers",
      "path": "/api/v1/vouchers",
      "csv": true,
      "what": "The vouchers, discounts and free money a UK household can claim but forgets: Healthy Start, Tax Free Childcare, the Warm Home Discount, council tax discounts, water and broadband social tariffs, free prescriptions, cheaper travel, Pension Credit and more. Each row carries the amount, who sets it, which nations it covers and the official source. Shop voucher codes are a separate list that stays empty until a checked feed exists, rather than being filled with codes that might not work.",
      "updates": "As schemes open, close and change their amounts."
    },
    {
      "id": "prices.history",
      "path": "/api/v1/prices/history",
      "csv": true,
      "what": "What each household charge has been over time, one row per dated change, with the primary source that set it: the TV Licence, NHS prescriptions and dental bands, regulated rail fares and the average water bill. The energy cap moves quarterly and rides in the body. Nobody else keeps a clean cross bill series with effective dates.",
      "updates": "As each charge changes, on its own timetable."
    },
    {
      "id": "fuel.prices",
      "path": "/api/v1/fuel/prices",
      "csv": true,
      "what": "The official weekly average UK pump price for petrol and diesel, thirteen weeks of trend plus the same week a year earlier, the tax inside a litre, the CMA's retailer margin monitoring, and the Fuel Finder scheme facts. Station level prices arrive once this site's Fuel Finder access is granted, and the dataset says so rather than serving stale stations.",
      "updates": "Weekly, when DESNZ publishes on Tuesdays."
    },
    {
      "id": "ev.charging",
      "path": "/api/v1/ev-charging",
      "csv": true,
      "what": "What every large public EV charging network publishes on its own pricing page, read twice by independent readers with disagreements settled by third verbatim reads: rates in pence per kWh, subscriptions, pre authorisation holds, overstay fees, and exactly what each operator says about prices varying by site. Networks that publish no national rate are recorded as such, never averaged.",
      "updates": "When operators change their published prices."
    },
    {
      "id": "groceries",
      "path": "/api/v1/groceries",
      "csv": true,
      "what": "The average UK price of 199 everyday grocery items this July against last July, from the ONS data behind the inflation figures, double parsed from two separately published files with zero disagreements. National averages only: the dataset carries the ONS's own statement of why per supermarket prices cannot lawfully be published, rather than pretending to a comparison nobody can source.",
      "updates": "Monthly, with each inflation release."
    },
    {
      "id": "council.tax",
      "path": "/api/v1/council-tax/rates",
      "csv": true,
      "what": "The actual council tax for every band in all 350 billing authorities in England, Wales and Scotland, from the government's own tables, every figure checked as an exact statutory ratio of its band D, with Northern Ireland's domestic rates poundages alongside. The averages every news story quotes hide a spread of thousands of pounds, and this is the spread.",
      "updates": "Annually, when the setting rounds finish in March."
    },
    {
      "id": "rent.tribunal",
      "path": "/api/v1/rent/tribunal",
      "csv": true,
      "what": "What the rent tribunal actually decides: 28 of its most recently published decisions, each read twice by independent readers, with the current, proposed and determined rent, the regime it was decided under, and whether hardship was raised and granted. Since 1 May 2026 the tribunal cannot go above the landlord's proposal, and these rows show the law working.",
      "updates": "As new decisions are published, a batch at a time."
    },
    {
      "id": "installer.checks",
      "path": "/api/v1/installer-checks",
      "csv": true,
      "what": "The registers that say whether a firm may do energy efficiency, heating or renewable work on a home, what each one actually guarantees and what it does not, which register covers which job, and the number format each one uses. We hold none of these registers and this dataset does not claim to: it is the map, not the territory.",
      "updates": "When a register changes what it publishes."
    },
    {
      "id": "home.upgrades",
      "path": "/api/v1/home-upgrades",
      "csv": true,
      "what": "Every UK grant and loan for insulation, heating and home upgrades, with its eligibility as testable conditions rather than prose, so software can answer whether a household qualifies and say which condition rules them out. Covers all four nations, and includes the closed schemes, because half the internet still lists them.",
      "updates": "As schemes open and close. ECO4 ends on 31 December 2026 with no successor."
    },
    {
      "id": "heat.networks",
      "path": "/api/v1/energy/heat-networks",
      "csv": true,
      "what": "How heat networks are regulated and what a customer on one is actually protected by. About 477,000 UK households buy heat from a monopoly they cannot switch away from, the energy price cap does not reach them, and Ofgem has only regulated the sector since 27 January 2026. Each protection carries its status and its date.",
      "updates": "As the regime commences in stages, the next being registration closing on 26 January 2027."
    },
    {
      "id": "water.charges",
      "path": "/api/v1/water/charges",
      "csv": true,
      "what": "What every UK water company actually charges: the rate per cubic metre, the standing charge, the rate per pound of rateable value and the assessed charges, read from each company's own charges scheme. Nobody collects these because households cannot switch, so there has never been a commercial reason to.",
      "updates": "Annually, when companies set charges for the year from 1 April."
    },
    {
      "id": "dictionary",
      "path": "/api/v1/dictionary",
      "csv": true,
      "what": "Every field in every dataset: its type, its unit, what it measures, and what a blank in it actually means. A null can be not published, does not apply, or not collected, and this is where those are told apart.",
      "updates": "When a field changes."
    },
    {
      "id": "sources",
      "path": "/api/v1/sources",
      "csv": true,
      "what": "Every source the site relies on, named and linked, so you can go and check any figure yourself.",
      "updates": "With the site."
    }
  ],
  "sources": [
    {
      "name": "Every source, listed",
      "url": "https://tarifftracker.io/api/v1/sources"
    }
  ],
  "caveats": [
    "Every response carries the sources behind it and a caveats list saying where those figures could be wrong. Both are part of the data, not decoration, and anything built on this should carry them through to whoever reads it.",
    "Figures change. Cache them if you must, but date what you cache, because a price with no date on it is worse than no price."
  ]
}