UK fuel price tracker

Returns: { "status": "ok" }

{
  "by_fuel_type": [
    { "fuel_type": "E10", "fuel_name": "Unleaded (E10)",
      "avg_price": 149.3, "min_price": 135.9, "max_price": 199.9,
      "station_count": 7277, "outliers_excluded": 12 }
  ],
  "by_country": [
    { "country_name": "England", "station_count": 5854 },
    { "country_name": "Scotland", "station_count": 742 }
  ],
  "total_stations": 7466,
  "total_prices": 24551,
  "last_scrape": "2026-03-25T14:00:00Z"
}

Returns: [ { region, avg_price, min_price, max_price, station_count } ]

Returns: [ { brand_name, forecourt_type, avg_price, min_price, max_price, station_count } ]

Returns: [ { forecourt_type, avg_price, min_price, max_price, station_count } ]

Returns: [ { admin_district, avg_price, min_price, max_price, station_count } ]

Returns: [ { parliamentary_constituency, avg_price, min_price, max_price, station_count } ]

Returns: [ { unified_label, avg_price, min_price, max_price, station_count, rural_urban_values } ]

Returns: { granularity, station: { trading_name, brand_name, city, postcode }, data: [ { bucket, avg_price } ] }

Returns: { granularity: "hourly"|"daily", data: [ { bucket, avg_price, stations } ] }

Returns: Streaming file download with full station & postcode enrichment for every historical observation.

Returns: array with node_id, trading_name, brand_name, city, postcode, price, fuel_name, forecourt_type, admin_district, rural_urban, parliamentary_constituency, latitude, longitude, is_motorway_service_station, is_supermarket_service_station

Returns: { results: [...], total, limit, offset }

Returns: Streaming file download with full station & postcode enrichment for every historical observation.

Access: any authenticated role. Caps: readonly max 200 IDs; editor/admin max 5000 IDs.

{
  "node_ids": ["node-a", "node-b", "node-c"]
}

Returns: { results: [...], requested, found, missing }. Result order matches the request order. Missing IDs are returned with found: false and null location fields. Each result includes postcode (corrected if overridden) and original_postcode (from source data).

Returns: [ { id, node_id, trading_name, city, brand_name, postcode, fuel_type, price, prev_price, anomaly_flags, observed_at, prev_observed_at } ]

prev_price reflects any correction applied to the previous record.

Flags: price_below_floor, price_above_ceiling, likely_decimal_error, large_price_jump

Returns: { bounds: { fuel_type: { q1, q3, iqr, lower_fence, upper_fence, total_stations } }, outliers: [...], total }

Each outlier has exclusion_reason: "anomaly_flagged" or "iqr_outlier" (Tukey IQR fence applied to the current price snapshot), plus original_price and corrected_price when a correction exists.

Returns: { station: { trading_name, brand_name, city, postcode }, records: [...] }

Each record: { fuel_price_id, fuel_type, fuel_name, original_price, corrected_price, effective_price, anomaly_flags, effective_flags, observed_at, correction_reason, corrected_by, corrected_at, prev_effective_price }

effective_flags: re-evaluated anomaly flags based on the effective (corrected or original) price.

Returns: [ { fuel_type_code, fuel_name, fuel_category } ]

Returns: [ "London", "North West", "Scotland", ... ]

Returns: [ "Birmingham", "Leeds", "Manchester", ... ]

Returns: [ "Aldershot", "Aldridge-Brownhills", ... ]

Returns: { rows: [...], total, limit, offset }

Each row: { id, started_at, finished_at, run_type, status, batches_fetched, stations_count, price_records_count, s3_key, error_message, duration_secs }

{ "raw_brand_name": "TESCO PFS", "canonical_brand": "Tesco" }

{ "canonical_brand": "Tesco", "forecourt_type": "Supermarket" }

Allowed types: Supermarket, Major Oil, Motorway Operator, Fuel Group, Convenience, Independent

{ "node_id": "abc123...", "canonical_brand": "Shell", "notes": "Branded Shell but API says independent" }

{ "canonical_brand": "Tesco", "node_ids": ["abc123", "def456", "ghi789"], "notes": "Bulk reclassification" }

Returns: { "saved": 3, "canonical_brand": "Tesco" }

Returns: [ { raw_brand, alias_resolved, override_resolved, final_brand, forecourt_type, resolution_method, station_count } ]

Returns: [ { node_id, trading_name, brand_name, postcode, api_latitude, api_longitude, city, county, coords_outside_uk, fixed_latitude, fixed_longitude, corrected_postcode, override_notes } ]

{ "latitude": 51.5, "longitude": -0.1 }

Returns: { postcode, latitude, longitude }

{}

Returns: { retried, resolved, still_failed }

Returns: { failed_count, last_checked_at }

Returns: [ { node_id, trading_name, brand_name, original_postcode, corrected_postcode, notes, created_at, lookup_succeeded } ]

{ "node_id": "abc123...", "corrected_postcode": "SW1A 1AA", "notes": "Typo in source data" }

Returns: { node_id, original_postcode, corrected_postcode, notes, lookup_status }

lookup_status: "enriched" (postcode recognised, full enrichment stored), "not_recognised" (postcodes.io didn't recognise it), or "lookup_failed" (network error, override still saved).

Returns: [ { username, email, status, enabled, groups, created } ]

{ "email": "user@example.com", "role": "editor" }

role accepts "admin", "editor", or "readonly" (default: no group = readonly).

{ "status": "ok", "message": "current_prices view refreshed" }

Returns: { rows: [...], total, limit, offset }

Each row: { corrected_at, original_price, corrected_price, reason, corrected_by, trading_name, city, fuel_type, fuel_name, observed_at }

{ "fuel_price_id": 12345, "corrected_price": 139.9 }

{ "corrections": [ { "fuel_price_id": 12345, "corrected_price": 139.9 }, ... ] }

Returns: { saved: 3, corrections: [ { id, fuel_price_id, corrected_price } ] }