Loading
Loading
Automatically resolve VAT or sales tax rates for a country using an IP address. Pass any IPv4 or IPv6 address to retrieve the applicable tax rates. If no IP is provided, the requesting IP is used automatically.
Ideal for e-commerce storefronts and SaaS platforms that need to surface local tax data without a separate geolocation step. For EU and UK IPs, the response includes the complete rate structure with category-specific rates.
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.
All parameters are optional. When ipAddress is omitted, the API resolves rates from the originating IP address.
formatoptionalStringdefault: jsonResponse format: 'json' (default) or 'xml'.
ipAddressoptionalStringIPv4 or IPv6 address to look up VAT rate for. If omitted, the requesting IP address is used automatically.
A successful request returns a 200 OK with a JSON array containing one VAT rate object for the resolved country.
countryCountry resolved from the IP address.
typeTax type for the resolved country (e.g., "vat").
currencyISO 4217 currency code for the resolved country.
standard_rateStandard VAT rate as a decimal.
reduced_rateReduced VAT rates (EU/UK only).
super_reduced_rateSuper-reduced VAT rates (EU/UK only).
parking_rateParking rate (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.
Invalid IP address format. Please provide a valid IPv4 or IPv6 address.
No VAT data found. Please provide a valid ipAddress.