Loading
Loading
Retrieve VAT or sales tax rates for any country worldwide. Returns standard, reduced, super-reduced, and category-specific rates where applicable. For US and Canada, add the optional state parameter for regional tax rates.
Accepts country in Alpha-2 (DE), Alpha-3 (DEU), or full name (Germany) format. Supports 125+ countries. For EU and UK markets, the response includes the complete rate structure including category-specific rates for books, newspapers, and broadcasting.
Authorize every request with your API key, passed either as a header or as a query parameter:
X-apiKeyapiKeyThis is version v1.0 of the API.
The country parameter is required. The state parameter is optional and must be used together with country.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
countryrequiredStringCountry identifier in Alpha-2 (DE), Alpha-3 (DEU), or full name (United_States). Case-insensitive; use underscores instead of spaces.
stateoptionalStringOptional state or region for sub-national VAT (e.g., New_York). Case-insensitive.
A successful request returns a 200 OK with a JSON array containing one VAT rate object for the requested country or state.
countryCountry identifier returned by the API.
stateState or region identifier for sub-national tax data.
typeTax type for the location (e.g., "vat" or "none").
currencyISO 4217 currency code for the country or state.
standard_rateStandard VAT or sales tax rate as a decimal (e.g., 0.19 = 19%).
reduced_rateReduced VAT rates when the country defines them (EU/UK only).
super_reduced_rateSuper-reduced VAT rates for eligible categories (EU/UK only).
parking_rateParking rate where defined (EU/UK only).
Category-specific VAT rates, where defined (EU/UK only). Keys vary by country - not every category below applies to every country.
Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.
X-Concurrent-Threadsheaderconcurrency-limited endpointsSpecifies the maximum number of concurrent requests allowed.
X-Concurrent-Threads-Activeheaderconcurrency-limited endpointsIndicates the number of active concurrent requests being processed.
X-AF-Credits-Costheaderall responsesSpecifies the number of credits consumed by the current request.
See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.
Bad request. Provide country query parameter or a combination of country and state query parameters.
No VAT data found.