{"openapi":"3.1.0","info":{"title":"VAT & Sales Tax API","version":"1.0.0","description":"VAT, GST and sales-tax rates for 128 countries — plus US state and Canadian province sub-rates — with a built-in tax calculator. Get the standard rate for any country (e.g. DE → 19%), compute the tax and gross total on a net amount (e.g. €100 in Germany → €19 tax, €119 total), apply a US state or Canadian province rate, or list every country. Ideal for e-commerce checkouts, invoicing, SaaS billing and pricing tools. (Standard rates, not tax advice.)","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/vat-api","description":"oanor gateway"}],"tags":[{"name":"Tax"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/calculate":{"get":{"operationId":"get_v1_calculate","tags":["Tax"],"summary":"Calculate tax & gross total on a net amount","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"2-letter ISO country code","schema":{"type":"string"},"example":"DE"},{"name":"amount","in":"query","required":true,"description":"Net amount","schema":{"type":"string"},"example":"100"},{"name":"state","in":"query","required":false,"description":"US state / Canadian province code (e.g. CA)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"net":100,"tax":19,"rate":0.19,"type":"vat","gross":119,"scope":"DE","country":"DE","currency":"EUR","rate_percent":19},"meta":{"timestamp":"2026-05-31T03:08:48.139Z","request_id":"b953bcdb-070f-4c72-9ddf-436498ba2882"},"status":"ok","message":"Tax calculated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/country":{"get":{"operationId":"get_v1_country","tags":["Tax"],"summary":"VAT / tax rate for a country","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"2-letter ISO country code","schema":{"type":"string"},"example":"DE"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"rate":0.19,"type":"vat","country":"DE","currency":"EUR","country_name":"Germany","rate_percent":19},"meta":{"timestamp":"2026-05-31T03:08:48.213Z","request_id":"bc265055-0201-40f5-b6a6-7a6cff645a9e"},"status":"ok","message":"Country tax retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Tax"],"summary":"All countries with their headline rate","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":128,"countries":[{"type":"vat","country":"AD","currency":"EUR","country_name":"Andorra","rate_percent":4.5},{"type":"vat","country":"AE","currency":"AED","country_name":"United Arab Emirates","rate_percent":5},{"type":"gst","country":"AI","currency":"XCD","country_name":"Anguilla","rate_percent":13},{"type":"vat","country":"AL","currency":"ALL","country_name":"Albania","rate_percent":20},{"type":"vat","country":"AM","currency":"AMD","country_name":"Armenia","rate_percent":20},{"type":"vat","country":"AO","currency":"AOA","country_name":"Angola","rate_percent":14},{"type":"vat","country":"AR","currency":"ARS","country_name":"Argentina","rate_percent":21},{"type":"vat","country":"AT","currency":"EUR","country_name":"Austria","rate_percent":20},{"type":"gst","country":"AU","currency":"AUD","country_name":"Australia","rate_percent":10},{"type":"vat","country":"AW","currency":"AWG","country_name":"Aruba","rate_percent":12.5},{"type":"vat","country":"AZ","currency":"AZN","country_name":"Azerbaijan","rate_percent":18},{"type":"vat","country":"BA","currency":"BAM","country_name":"Bosnia and Herzegovina","rate_percent":17},{"type":"vat","country":"BB","currency":"BBD","country_name":"Barbados","rate_percent":17.5},{"type":"vat","country":"BE","currency":"EUR","country_name":"Belgium","rate_percent":21},{"type":"vat","country":"BG","currency":"BGN","country_name":"Bulgaria","rate_percent":20},{"type":"vat","country":"BH","currency":"BHD","country_name":"Bahrain","rate_percent":5},{"type":"vat","country":"BO","currency":"BOB","country_name":"Bolivia","rate_percent":14.94},{"type":"vat","country":"BR","currency":"BRL","country_name":"Brazil","rate_percent":17},{"type":"vat","country":"BS","currency":"BSD","country_name":"Bahamas","rate_percent":12},{"type":"vat","country":"BW","currency":"BWP","country_name":"Botswana","rate_percent":14},{"type":"vat","country":"BY","currency":"BYN","country_name":"Belarus","rate_percent":20},{"type":"gst","country":"CA","currency":"CAD","country_name":"Canada","rate_percent":5},{"type":"vat","country":"CH","currency":"CHF","country_name":"Switzerland","rate_percent":8.1},{"type":"vat","country":"CL","currency":"CLP","country_name":"Chile","rate_percent":19},{"type":"vat","country":"CN","currency":"CNY","country_name":"China","rate_percent":13},{"type":"vat","country":"CO","currency":"COP","country_name":"Colombia","rate_percent":19},{"type":"vat","country":"CR","currency":"CRC","country_name":"Costa Rica","rate_percent":13},{"type":"vat","country":"CW","currency":"ANG","country_name":"Curacao","rate_percent":6},{"type":"vat","country":"CY","currency":"EUR","country_name":"Cyprus","rate_percent":19},{"type":"vat","country":"CZ","currency":"CZK","country_name":"Czechia","rate_percent":21},{"type":"vat","country":"DE","currency":"EUR","country_name":"Germany","rate_percent":19},{"type":"vat","country":"DK","currency":"DKK","country_name":"Denmark","rate_percent":25},{"type":"vat","country":"DO","currency":"DOP","country_name":"Dominican Republic","rate_percent":18},{"type":"vat","country":"DZ","currency":"DZD","country_name":"Algeria","rate_percent":19},{"type":"vat","country":"EC","currency":"USD","country_name":"Ecuador","rate_percent":12},{"type":"vat","country":"EE","currency":"EUR","country_name":"Estonia","rate_percent":24},{"type":"vat","country":"EG","currency":"EGP","country_name":"Egypt","rate_percent":14},{"type":"vat","country":"ER","currency":"ERN","country_name":"Eritrea","rate_percent":5},{"type":"vat","country":"ES","currency":"EUR","country_name":"Spain","rate_percent":21},{"type":"vat","country":"FI","currency":"EUR","country_name":"Finland","rate_percent":25.5},{"type":"vat","country":"FR","currency":"EUR","country_name":"France","rate_percent":20},{"type":"vat","country":"GB","currency":"GBP","country_name":"United Kingdom","rate_percent":20},{"type":"vat","country":"GE","currency":"GEL","country_name":"Georgia","rate_percent":18},{"type":"vat","country":"GH","currency":"GHS","country_name":"Ghana","rate_percent":15},{"type":"vat","country":"GR","currency":"EUR","country_name":"Greece","rate_percent":24},{"type":"vat","country":"GT","currency":"GTQ","country_name":"Guatemala","rate_percent":12},{"type":"vat","country":"HN","currency":"HNL","country_name":"Honduras","rate_percent":15},{"type":"vat","country":"HR","currency":"EUR","country_name":"Croatia","rate_percent":25},{"type":"vat","country":"HU","currency":"HUF","country_name":"Hungary","rate_percent":27},{"type":"vat","country":"ID","currency":"IDR","country_name":"Indonesia","rate_percent":11},{"type":"vat","country":"IE","currency":"EUR","country_name":"Ireland","rate_percent":23},{"type":"vat","country":"IL","currency":"ILS","country_name":"Israel","rate_percent":18},{"type":"vat","country":"IM","currency":"GBP","country_name":"Isle of Man","rate_percent":20},{"type":"gst","country":"IN","currency":"INR","country_name":"India","rate_percent":18},{"type":"vat","country":"IS","currency":"ISK","country_name":"Iceland","rate_percent":24},{"type":"vat","country":"IT","currency":"EUR","country_name":"Italy","rate_percent":22},{"type":"vat","country":"JE","currency":"GBP","country_name":"Jersey","rate_percent":5},{"type":"vat","country":"JO","currency":"JOD","country_name":"Jordan","rate_percent":16},{"type":"vat","country":"JP","currency":"JPY","country_name":"Japan","rate_percent":10},{"type":"vat","country":"KE","currency":"KES","country_name":"Kenya","rate_percent":16},{"type":"vat","country":"KR","currency":"KRW","country_name":"South Korea","rate_percent":10},{"type":"vat","country":"KW","currency":"KWD","country_name":"Kuwait","rate_percent":5},{"type":"vat","country":"KZ","currency":"KZT","country_name":"Kazakhstan","rate_percent":12},{"type":"vat","country":"LB","currency":"LBP","country_name":"Lebanon","rate_percent":11},{"type":"vat","country":"LC","currency":"XCD","country_name":"Saint Lucia","rate_percent":12.5},{"type":"vat","country":"LI","currency":"CHF","country_name":"Liechtenstein","rate_percent":7.7},{"type":"vat","country":"LK","currency":"LKR","country_name":"Sri Lanka","rate_percent":12},{"type":"vat","country":"LT","currency":"EUR","country_name":"Lithuania","rate_percent":21},{"type":"vat","country":"LU","currency":"EUR","country_name":"Luxembourg","rate_percent":17},{"type":"vat","country":"LV","currency":"EUR","country_name":"Latvia","rate_percent":21},{"type":"vat","country":"MA","currency":"MAD","country_name":"Morocco","rate_percent":20},{"type":"vat","country":"MC","currency":"EUR","country_name":"Monaco","rate_percent":20},{"type":"vat","country":"MD","currency":"MDL","country_name":"Moldova","rate_percent":20},{"type":"vat","country":"MG","currency":"MGA","country_name":"Madagascar","rate_percent":20},{"type":"vat","country":"MK","currency":"MKD","country_name":"North Macedonia","rate_percent":18},{"type":"vat","country":"MM","currency":"MMK","country_name":"Myanmar","rate_percent":5},{"type":"vat","country":"MN","currency":"MNT","country_name":"Mongolia","rate_percent":10},{"type":"vat","country":"MT","currency":"EUR","country_name":"Malta","rate_percent":18},{"type":"vat","country":"MU","currency":"MUR","country_name":"Mauritius","rate_percent":15},{"type":"gst","country":"MV","currency":"MVR","country_name":"Maldives","rate_percent":8},{"type":"vat","country":"MX","currency":"MXN","country_name":"Mexico","rate_percent":16},{"type":"vat","country":"MY","currency":"MYR","country_name":"Malaysia","rate_percent":10},{"type":"vat","country":"NA","currency":"NAD","country_name":"Namibia","rate_percent":15},{"type":"vat","country":"NG","currency":"NGN","country_name":"Nigeria","rate_percent":7.5},{"type":"vat","country":"NI","currency":"NIO","country_name":"Nicaragua","rate_percent":15},{"type":"vat","country":"NL","currency":"EUR","country_name":"The Netherlands","rate_percent":21},{"type":"vat","country":"NO","currency":"NOK","country_name":"Norway","rate_percent":25},{"type":"gst","country":"NZ","currency":"NZD","country_name":"New Zealand","rate_percent":15},{"type":"vat","country":"OM","currency":"OMR","country_name":"Oman","rate_percent":5},{"type":"vat","country":"PA","currency":"USD","country_name":"Panama","rate_percent":7},{"type":"vat","country":"PE","currency":"PEN","country_name":"Peru","rate_percent":18},{"type":"vat","country":"PG","currency":"PGK","country_name":"Papua New Guinea","rate_percent":10},{"type":"vat","country":"PH","currency":"PHP","country_name":"Philippines","rate_percent":12},{"type":"vat","country":"PK","currency":"PKR","country_name":"Pakistan","rate_percent":17},{"type":"vat","country":"PL","currency":"PLN","country_name":"Poland","rate_percent":23},{"type":"vat","country":"PR","currency":"USD","country_name":"Puerto Rico","rate_percent":11.5},{"type":"vat","country":"PT","currency":"EUR","country_name":"Portugal","rate_percent":23},{"type":"vat","country":"PY","currency":"PYG","country_name":"Paraguay","rate_percent":10},{"type":"vat","country":"QA","currency":"QAR","country_name":"Qatar","rate_percent":5},{"type":"vat","country":"RO","currency":"RON","country_name":"Romania","rate_percent":21},{"type":"vat","country":"RS","currency":"RSD","country_name":"Serbia","rate_percent":20},{"type":"vat","country":"RU","currency":"RUB","country_name":"Russia","rate_percent":20},{"type":"vat","country":"RW","currency":"RWF","country_name":"Rwanda","rate_percent":18},{"type":"vat","country":"SA","currency":"SAR","country_name":"Saudi Arabia","rate_percent":15},{"type":"vat","country":"SC","currency":"SCR","country_name":"Seychelles","rate_percent":15},{"type":"vat","country":"SE","currency":"SEK","country_name":"Sweden","rate_percent":25},{"type":"gst","country":"SG","currency":"SGD","country_name":"Singapore","rate_percent":9},{"type":"vat","country":"SI","currency":"EUR","country_name":"Slovenia","rate_percent":22},{"type":"vat","country":"SK","currency":"EUR","country_name":"Slovakia","rate_percent":23},{"type":"vat","country":"SR","currency":"SRD","country_name":"Suriname","rate_percent":15},{"type":"vat","country":"SV","currency":"USD","country_name":"El Salvador","rate_percent":13},{"type":"vat","country":"TH","currency":"THB","country_name":"Thailand","rate_percent":10},{"type":"vat","country":"TN","currency":"TND","country_name":"Tunisia","rate_percent":19},{"type":"vat","country":"TR","currency":"TRY","country_name":"Turkey","rate_percent":20},{"type":"vat","country":"TT","currency":"TTD","country_name":"Trinidad and Tobago","rate_percent":12.5},{"type":"vat","country":"TW","currency":"TWD","country_name":"Taiwan","rate_percent":5},{"type":"vat","country":"TZ","currency":"TZS","country_name":"Tanzania","rate_percent":18},{"type":"vat","country":"UA","currency":"UAH","country_name":"Ukraine","rate_percent":20},{"type":"vat","country":"UG","currency":"UGX","country_name":"Uganda","rate_percent":18},{"type":"none","country":"US","currency":"USD","country_name":"United States","rate_percent":0},{"type":"vat","country":"UY","currency":"UYU","country_name":"Uruguay","rate_percent":22},{"type":"vat","country":"UZ","currency":"UZS","country_name":"Uzbekistan","rate_percent":12},{"type":"vat","country":"VE","currency":"VES","country_name":"Venezuela","rate_percent":16},{"type":"vat","country":"VN","currency":"VND","country_name":"Vietnam","rate_percent":10},{"type":"vat","country":"XK","currency":"EUR","country_name":"Kosovo","rate_percent":18},{"type":"vat","country":"ZA","currency":"ZAR","country_name":"South Africa","rate_percent":15},{"type":"vat","country":"ZM","currency":"ZMW","country_name":"Zambia","rate_percent":16},{"type":"vat","country":"ZW","currency":"USD","country_name":"Zimbabwe","rate_percent":15}]},"meta":{"timestamp":"2026-05-31T03:08:48.281Z","request_id":"91f07251-f1a9-4797-8183-54afa0a1e6f0"},"status":"ok","message":"Countries listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Headline standard rates; sub-rates for US states and Canadian provinces. Not tax advice.","total":128,"types":["vat","gst","none"],"source":"node-sales-tax dataset","with_state_rates":3},"meta":{"timestamp":"2026-05-31T03:08:48.328Z","request_id":"fee73ab8-ff98-4c67-8058-5dc89a5a2769"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":800,"monthly_call_quota":45000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":250000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5800,"monthly_call_quota":1100000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/vat-api"}