Loading
Loading
Fetch VAT rates for multiple countries in a single POST request. Returns a JSON array of VAT rate objects, one per requested country entry. Supports the same country and state identifiers as the single GET endpoint.
Send a JSON body with a countries array. Each entry accepts a country field (required) and an optional state field for sub-national lookups. The response preserves the order of the requested countries.
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.
Optional query parameter to control the response format.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
The request body must be a JSON object containing a countries array, where each item includes a country code and an optional state.
{
"countries": [
{
"country": "DE"
},
{
"country": "United_States",
"state": "New_York"
}
]
}countriesrequiredArray<Object>Array of country objects to fetch VAT rates for.
Each object in the countries array supports the following fields:
countryrequiredStringCountry code in Alpha-2 (DE), Alpha-3 (DEU), or full name (Germany) format.
stateoptionalStringState or region name for sub-national VAT lookup (e.g., New_York, California).
A successful request returns a 200 OK response with an object containing a countries array. Each array item represents the VAT lookup result for one requested country entry.
For EU countries and the UK, countries array items may also include the additional VAT-specific fields (reduced_rate, super_reduced_rate, parking_rate, categories).
country (String), state (String), type (String), currency (String), standard_rate (Float), …
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.
Invalid JSON payload.