{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://agentdatafeed.com/schema/fuel-price.schema.json","title":"Weekly average fuel price","description":"One weekly average fuel price for one country (or US region), fuel type and tax basis, as published by the European Commission Weekly Oil Bulletin, UK DESNZ or US EIA. Prices are as published; no currency conversion.","type":"object","required":["id","country","fuel_type","fuel_label","week","price","currency","unit","with_taxes","series","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^(WOB|DESNZ|EIA)-[A-Z]{2}(-[A-Z0-9]+)?-[a-z0-9_]+-[TN]-\\d{4}-\\d{2}-\\d{2}$","description":"Source prefix, area, fuel type, T (with taxes) or N (without taxes) and week"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 code; EU for the European Union weighted average and EA for the euro area weighted average (Weekly Oil Bulletin). GB for the United Kingdom, GR for Greece"},"region":{"type":["string","null"],"description":"EIA area name for US regional series (PADD, state or city), for example East Coast (PADD 1) or California; null for a national average"},"region_code":{"type":["string","null"],"pattern":"^[A-Z0-9]+$","description":"EIA area code from the series id, for example R10 (East Coast PADD 1), SCA (California), Y35NY (New York City); null for a national average"},"fuel_type":{"enum":["petrol_95","diesel","heating_oil","lpg","petrol_regular","petrol_midgrade","petrol_premium","petrol_all_grades"],"description":"Normalised fuel type. petrol_95: Euro-super 95 (EU) or ULSP unleaded petrol (UK); petrol_regular, petrol_midgrade, petrol_premium and petrol_all_grades: US gasoline grades, all formulations; diesel: automotive gas oil (EU), ULSD (UK) or No 2 on-highway diesel (US); heating_oil: heating gas oil delivered to households (EU); lpg: LPG motor fuel (EU)"},"fuel_label":{"type":"string","description":"Fuel as labelled by the source"},"week":{"type":"string","format":"date","description":"Date of the weekly price as published (a Monday for all three sources)"},"price":{"type":"number","exclusiveMinimum":0,"description":"Weekly average price in the published unit"},"currency":{"enum":["EUR","GBP","USD"]},"unit":{"enum":["EUR per 1000 l","pence per litre","USD per US gallon"],"description":"Unit as published: EUR per 1000 litres (Weekly Oil Bulletin), pence (GBP) per litre (DESNZ), US dollars per US gallon (EIA)"},"price_per_litre_eur":{"type":["number","null"],"description":"EUR per litre, only where the source publishes EUR (Weekly Oil Bulletin price divided by 1000); null otherwise. No currency conversion"},"with_taxes":{"type":"boolean","description":"true: consumer price including duties and VAT; false: price before duties and taxes (Weekly Oil Bulletin only)"},"series":{"type":"string","pattern":"^[A-Z0-9]+$","description":"Series key: country, EIA area code and fuel type in upper case without separators, for example DEDIESEL or USSCAPETROLREGULAR"},"duty_pence_per_litre":{"type":["number","null"],"description":"UK fuel duty rate in pence per litre for the week (DESNZ only)"},"vat_rate_percent":{"type":["number","null"],"description":"UK VAT rate in % for the week (DESNZ only)"},"eia_series":{"type":"string","description":"EIA series id, for example EMM_EPMR_PTE_NUS_DPG (EIA only)"},"url":{"type":"string","format":"uri","description":"Official page of the publication"},"verification":{"const":"official-publication"},"paid_placement":{"const":false},"source_id":{"enum":["ec-weekly-oil-bulletin","desnz-weekly-road-fuel-prices","eia-weekly-retail-fuel-prices"]},"source_url":{"type":"string","format":"uri","description":"File the value was read from"},"retrieved_at":{"type":"string","format":"date-time"}}}