{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"customs-tariff.schema.json","title":"Import duty rate per tariff schedule, commodity code and measure (official)","description":"Sources: UK Global Tariff from the Department for Business and Trade data API (Open Government Licence v3.0); Harmonized Tariff Schedule of the United States from the US International Trade Commission (US federal government work). Duties as published, no currency conversion. UK preferential measures, quotas, trade remedies and other import measures are not included. Not customs advice; the published tariff and legislation are authoritative.","type":"object","required":["id","schedule","schedule_name","commodity_code","hs6","chapter","shard","code_display","description","description_path","measure","measure_label","origin_group","origin_codes","duty_text","ad_valorem_percent","specific_amount","specific_currency","specific_unit","parse_status","units","additional_code","additional_code_description","conditions","valid_from","valid_to","legal_base","legal_base_url","release","release_date","authority","source_link","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Schedule, commodity code, measure and a short hash of the origin group, additional code, start date and duty"},"schedule":{"type":"string","description":"Tariff schedule: GB (UK Global Tariff) or US (Harmonized Tariff Schedule of the United States)","enum":["GB","US"]},"schedule_name":{"type":"string","description":"Name of the tariff schedule"},"commodity_code":{"type":"string","description":"Commodity code as digits only: 10 digits for the UK (HS 6 plus national digits), 8 or 10 digits for the US","pattern":"^[0-9]{4,10}$"},"hs6":{"type":["string","null"],"description":"First 6 digits (HS subheading); null where the code has fewer digits","pattern":"^[0-9]{6}$"},"chapter":{"type":"string","description":"HS chapter, first 2 digits","pattern":"^[0-9]{2}$"},"shard":{"type":"string","description":"Published file the record is in: schedule and chapter (for example GB84), for US chapter 99 schedule and 6-digit subheading (US990302)","pattern":"^(GB|US)[0-9]{2,6}$"},"code_display":{"type":"string","description":"Commodity code as published, for example 0101.21.00 in the HTS"},"description":{"type":"string","description":"Description of the code line as published"},"description_path":{"type":"array","items":{"type":"string"},"description":"Descriptions of the parent lines from the chapter or heading down, as published"},"measure":{"type":"string","description":"third_country: the MFN or general duty (UK third country duty, US general column 1); end_use: UK third country duty under authorised use; preferential: a group of the US special column; column_2: US column 2 rate for the countries in general note 3(b)","enum":["third_country","end_use","preferential","column_2"]},"measure_label":{"type":"string","description":"Measure type or column as published"},"origin_group":{"type":["string","null"],"description":"Origin the measure applies to as published (ERGA OMNES for all countries) or the US special programme indicators"},"origin_codes":{"type":"array","items":{"type":"string"},"description":"UK geographical area id, or the US special programme indicators as published (for example A+, AU, KR)"},"duty_text":{"type":"string","description":"Duty rate as published, for example 12% + 93.10 GBP / 100 kg or $1.104/kg + 14.9%"},"ad_valorem_percent":{"type":["number","null"],"description":"Ad valorem component in percent; 0 when the duty is free; null when not parseable"},"specific_amount":{"type":["number","null"],"description":"Specific component in the main currency unit (US cents converted to dollars: 1.1 cents is 0.011 USD); null when none or not parseable"},"specific_currency":{"type":["string","null"],"description":"Currency of the specific component (GBP, EUR, USD)"},"specific_unit":{"type":["string","null"],"description":"Unit of the specific component as published, for example 100 kg, hl, % vol / hl, kg, each"},"parse_status":{"type":"string","description":"free, ad_valorem, specific or compound (ad valorem plus specific) when the duty text was parsed in full; text_only for other wordings (maximum or minimum clauses, references to other headings), the parsed fields are then null","enum":["free","ad_valorem","specific","compound","text_only"]},"units":{"type":"array","items":{"type":"string"},"description":"Units of quantity as published (US statistical units, including those of the 10-digit statistical lines under an 8-digit rate line); empty for the UK"},"additional_code":{"type":["string","null"],"description":"UK additional code the measure applies to"},"additional_code_description":{"type":["string","null"],"description":"Description of the UK additional code"},"conditions":{"type":["string","null"],"description":"UK measure conditions as published (for example the authorisation needed for end use)"},"valid_from":{"type":["string","null"],"description":"First day the measure applies (UK); null for the US, where the release applies","format":"date"},"valid_to":{"type":["string","null"],"description":"Last day the measure applies (UK); null while in force or not given","format":"date"},"legal_base":{"type":["string","null"],"description":"Regulation or statutory instrument as published (UK); null where not given"},"legal_base_url":{"type":["string","null"],"format":"uri","description":"Link to the legal base"},"release":{"type":"string","description":"Schedule release: UK data API dataset version or HTS revision name"},"release_date":{"type":["string","null"],"description":"Start date of the HTS revision; null for the UK","format":"date"},"authority":{"type":"string","description":"Publishing authority"},"source_link":{"type":"string","format":"uri","description":"Official human-readable page for the code"},"verification":{"type":"string","enum":["official-publication"]},"paid_placement":{"type":"boolean","const":false},"source_id":{"type":"string","description":"Source id in sources/registry.yaml"},"source_url":{"type":"string","format":"uri","description":"Bulk file the record was read from"},"retrieved_at":{"type":"string","format":"date-time"}}}