{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"excise-duty.schema.json","title":"Excise duty rate per country, product category, rate type and validity period (official)","description":"Sources: HMRC Alcohol Duty, Tobacco Products Duty and hydrocarbon oils (Fuel Duty) rates on GOV.UK via the content API (Open Government Licence v3.0); Alcohol and Tobacco Tax and Trade Bureau (TTB) federal excise tax rates (US federal government work, free to copy with credit to TTB); New Zealand Customs Service Excise and Excise-equivalent Duties Table, Part A (CC BY 4.0 NZ). Rates, currencies and units as published, no currency conversion. Not tax advice; the national legislation is authoritative.","type":"object","required":["id","country","product_category","product_label","rate_type","rate","rate_text","currency","unit","ad_valorem_percent","conditions","valid_from","valid_from_exact","valid_to","authority","source_link","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Country, product category, rate type and a short hash of the label, rate, unit and period"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code"},"product_category":{"type":"string","enum":["beer","wine","sparkling_wine","cider","other_fermented","intermediate","spirits","other_alcohol","cigarettes","cigars","fine_cut","pipe_tobacco","chewing_tobacco","snuff","heated_tobacco","raw_tobacco","other_tobacco","cigarette_papers_tubes","petrol","diesel","gas_oil","kerosene","fuel_oil","aviation_fuel","biofuel","lpg","natural_gas","electricity","other_fuel","other"],"description":"Normalised product category. fine_cut is hand-rolling or roll-your-own tobacco; intermediate is fortified or flavoured wine such as vermouth; other_fermented covers fermented products other than beer, wine and cider (for example fruit wine, perry, mead, saké where the source groups them so); other_alcohol covers alcohol in foods and rates for several alcohol categories together. The source label is kept in product_label"},"product_label":{"type":"string","description":"Product description as published, with the section and alcohol band; for New Zealand the excise item number, heading and sub-headings"},"rate_type":{"type":"string","enum":["standard","reduced","minimum","maximum","zero"],"description":"standard (the general rate), reduced (a lower rate for a qualifying use, producer size, draught product or temporary period; see conditions), minimum (minimum excise tax), maximum (cap on an ad valorem duty) or zero (published as Free or 0)"},"rate":{"type":["number","null"],"minimum":0,"description":"Specific duty amount in the currency per unit as published (cents converted to the main unit, for example 58.492 NZ cents is 0.58492); null for a purely ad valorem rate"},"rate_text":{"type":"string","description":"Rate wording as published"},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 currency of the rate as published (GBP, USD, NZD); no conversion"},"unit":{"type":["string","null"],"description":"Unit the rate applies to as published, for example per litre of pure alcohol, per 1,000 cigarettes, per kg, per proof gallon, per barrel (31 gallons), per litre; null where the source states none (Free items)"},"ad_valorem_percent":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Ad valorem part in percent of the retail or sales price where the source states one (for example UK cigarettes 16.5% of retail price, US large cigars 52.75% of sales price); null otherwise"},"conditions":{"type":["string","null"],"description":"Conditions, eligibility or additions as published or summarised from the source (for example reduced rates for small producers, draught relief, the temporary period, or 'plus 8¢ per g of Pb'); null if none"},"valid_from":{"type":["string","null"],"format":"date","description":"First day the rate applies as published; for New Zealand the effective date of the table edition (the rate may have applied earlier, valid_from_exact false); null where the source states no date"},"valid_from_exact":{"type":"boolean","description":"true when valid_from is the date the rate took effect as stated by the source; false when it is the date of the table edition"},"valid_to":{"type":["string","null"],"format":"date","description":"Last day the rate applies as published; null while in force"},"authority":{"type":"string","description":"Publishing authority"},"source_link":{"type":"string","format":"uri","description":"Official human-readable page"},"verification":{"type":"string","enum":["official-publication"]},"paid_placement":{"type":"boolean","const":false},"source_id":{"type":"string"},"source_url":{"type":"string","format":"uri","description":"URL the record was read from (API endpoint, page or PDF)"},"retrieved_at":{"type":"string","format":"date-time"}}}