VAT Rates API

Frequently Asked Questions

• Can I use the VAT Rates API for commercial purposes?

  Yes, but you must have a premium subscription. Commercial use of the VAT Rates API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.

• How do I get an API key and start using the VAT Rates API?

  Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.

• What happens if I exceed my quota for the month?

  Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.

• What happens if a request to the VAT Rates API fails?

  The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.

• What VAT data does the VAT Rates API provide and which countries are covered?

  The VAT Rates API returns current and historical Value Added Tax rates for all countries in the European Union, including the standard rate, reduced rates, super-reduced rates, and special categories. For sales and consumption tax rates of non-EU countries, use the Sales Tax API instead.

• How do I look up VAT rates for a specific EU country?

  Send a GET request to the /v1/vat endpoint with the required country parameter set to a two-letter ISO 3166-1 alpha-2 code (for example FR). You can also filter with the optional type parameter (standard, reduced, super_reduced, exempted, or parking) and review the related Income Tax API for direct tax data.

• What fields are included in the VAT Rates API response?

  The API returns a JSON array of objects, each with a country code, the rate type, the rate as a percentage, the effective date, and an optional category describing the goods or services the rate applies to. If a request is unsuccessful, an error is returned instead.

• How can I retrieve historical VAT rates or page through results?

  Use the min_date and max_date parameters (in YYYY-MM-DD format) to filter rates by their effective date, and the premium limit (1-30, default 5) and offset parameters to paginate. The premium pagination parameters require a paid plan, which you can compare on the pricing page.

• Can I check whether a customer's VAT number is valid?

  Yes — use the companion VAT Validation API, which validates any EU VAT number with instant format and checksum checks plus live EU registry status, and returns company name, address, and audit-ready consultation numbers on paid plans.