{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"vat-rate.schema.json","title":"VAT and GST rate per country, region and category (current and historical)","description":"Sources: European Commission Taxes in Europe Database (TEDB) VAT rates retrieval web service for the 27 EU member states (Commission reuse policy, Decision 2011/833/EU, CC BY 4.0); HMRC VAT rates on GOV.UK (Open Government Licence v3.0); Canada Revenue Agency GST/HST rate table on open.canada.ca (Open Government Licence - Canada); Inland Revenue New Zealand GST pages (CC BY 4.0); Skatteetaten VAT rates (Norway); National Tax Agency Tax Answer No.6303 (Japan, Public Data License 1.0); Skatturinn VAT rates (Iceland); A New Tax System (Goods and Services Tax) Act 1999 on the Federal Register of Legislation (Australia, CC BY 4.0). Category texts as published. Not tax advice; the national legislation is authoritative.","type":"object","required":["id","country","region","tax","rate_type","rate","rate_text","category_code","category","description","cn_codes","cpa_codes","valid_from","valid_from_exact","valid_to","source_rate_type","authority","source_link","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","description":"Region or country code, rate type and a short hash of the rate, category, CN and CPA codes and period"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"ISO 3166-1 alpha-2 country code (GR for Greece, which TEDB lists as EL)"},"region":{"type":["string","null"],"pattern":"^[A-Z]{2}-[A-Z0-9]{1,3}$","description":"ISO 3166-2 subdivision code where the rate differs by region (Canadian provinces and territories, for example CA-ON); null for a nationwide rate. Regional EU rates (for example islands or outermost regions) are described in the description text as TEDB publishes them"},"tax":{"type":"string","enum":["VAT","GST","HST","JCT"],"description":"Tax: VAT, GST, Canadian HST (harmonised GST and provincial part) or JCT (Japanese consumption tax, national and local parts combined)"},"rate_type":{"type":"string","enum":["standard","reduced","super-reduced","parking","zero","exempt","out-of-scope"],"description":"standard, reduced, super-reduced, parking, zero (0% with right to deduct input tax), exempt or out-of-scope. TEDB REDUCED_RATE at 0% is zero here. TEDB uses EXEMPTED for both exemptions and some 0% rates with the right to deduct (for example Irish food) and does not say which; those records are exempt here with rate 0 as published, see source_rate_type and description, and query type=zero,exempt to get both. Australian GST-free supplies are zero and input taxed supplies are exempt"},"rate":{"type":["number","null"],"minimum":0,"maximum":100,"description":"Rate in percent as published; null where the source states no number (exempt or out of scope, or 'standard-rated' in the GOV.UK guide)"},"rate_text":{"type":["string","null"],"description":"Rate wording as published by GOV.UK, CRA, Inland Revenue, Skatteetaten, the National Tax Agency or Skatturinn (for Australia the rate, GST-free or Input taxed); null for TEDB"},"category_code":{"type":["string","null"],"description":"TEDB category identifier, for example FOODSTUFFS or ACCOMMODATION, or the Australian GST Act Subdivision, for example Subdivision 38-A; null for the other sources and for standard rates"},"category":{"type":["string","null"],"description":"Category of goods or services the rate applies to, as published (Japanese and Icelandic texts in the original language); null for TEDB standard rates"},"description":{"type":["string","null"],"description":"Further text as published: the TEDB comment (often in the national wording and with legal references), the GOV.UK section and VAT notice, or the CRA federal and provincial split"},"cn_codes":{"type":"array","items":{"type":"string"},"description":"Combined Nomenclature codes TEDB links to this rate (codes only); empty if none"},"cpa_codes":{"type":"array","items":{"type":"string"},"description":"CPA product codes TEDB links to this rate (codes only); empty if none"},"valid_from":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"First day the rate applies (ISO 8601); null if the source gives no start date"},"valid_from_exact":{"type":"boolean","description":"true if valid_from is a change date stated by the source; false if it is only the start of the history available from the source (the rate may have applied earlier)"},"valid_to":{"type":["string","null"],"format":"date","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Last day the rate applies (ISO 8601); null if still in force"},"source_rate_type":{"type":["string","null"],"description":"Rate type as published by TEDB (DEFAULT, REDUCED_RATE, SUPER_REDUCED_RATE, PARKING_RATE, EXEMPTED, OUT_OF_SCOPE); null for the other sources"},"authority":{"type":"string","description":"Publishing tax authority"},"source_link":{"type":"string","format":"uri","description":"Official page for this rate"},"verification":{"type":"string","enum":["official-publication"],"description":"Taken from the official publication of the tax authority"},"paid_placement":{"type":"boolean","const":false,"description":"Always false; no record is paid for"},"source_id":{"type":"string","enum":["ec-tedb-vat-rates","gov-uk-hmrc-vat-rates","ca-cra-gst-hst-rates","nz-ird-gst","no-skatteetaten-vat","jp-nta-consumption-tax","is-skatturinn-vat","au-legislation-gst-act"]},"source_url":{"type":"string","format":"uri","description":"URL the record was collected from"},"retrieved_at":{"type":"string","format":"date-time"}}}