{
  "dataset": "index",
  "generated": "2026-08-27T16:32:45.652Z",
  "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-08-27T11:03:53.687Z",
    "energy_tariffs_note": null
  },
  "movement": {
    "tariffs_checked": 350,
    "tariffs_checked_at": "2026-08-27T11:03:53.687Z",
    "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": 83
  },
  "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": "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": "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."
  ]
}