NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

VAT Rates API

The VAT Rates API provides current and historical Value Added Tax (VAT) rates for all countries in the European Union.

Need to validate a customer's VAT number? Use the VAT Validation API. For sales/consumption tax rates of non-EU countries, please use the Sales Tax API.

(4.5)

From 9,947 users

2,600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
358ms407ms449ms727ms1138ms

Didn't find what you were looking for? Suggest an improvement

/v1/vat GET

https://api.api-ninjas.com/v1/vat

Returns VAT rates for a specified EU country. Results include standard rate, reduced rates, super-reduced rates, and any special categories.

Standard rates are available to all users. Rate values for all other rate types (reduced, super-reduced, exempted, parking) are available to premium subscribers only — free accounts still see these entries, but the rate field contains a premium-only notice instead of the numeric rate.

By default up to 5 results are returned. Use the limit and offset parameters to paginate through results.

Parameters

  • country  required

    Two-letter country code (ISO 3166-1 alpha-2).

  • type  optional

    VAT rate type. Possible values: standard, reduced, super_reduced, exempted, parking. Numeric rate values for types other than standard require a premium subscription.

  • min_date  optional

    Filter results after this date (YYYY-MM-DD format).

  • max_date  optional

    Filter results before this date (YYYY-MM-DD format).

  • limit  optional premium only

    Number of results to return (1-100). Default is 5.

  • offset  optional premium only

    Number of results to offset for pagination. Default is 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.

  • country

    Two-letter country code (ISO 3166-1 alpha-2).

  • type

    VAT rate type (for example standard, reduced, super_reduced, exempted, parking).

  • rate

    VAT rate as a percentage (for example 21 for 21%). For rate types other than standard, the numeric value is shown to premium subscribers only; free accounts receive a premium-only notice in this field.

  • date

    The effective date for this VAT rate (YYYY-MM-DD).

  • category

    Optional description of the goods/services category this rate applies to.

Sample Request Live Demo!

country
type
min_date
max_date

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/vat?country=FR

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      country:"FR",
      type:"standard",
      rate:20,
      date:"2025-01-01"
    },
    {
      country:"FR",
      type:"reduced_rate",
      rate:5.5,
      date:"2025-01-01",
      category:"Domestic care services such as home help and care of the young, elderly, sick or disabled"
    },
    {
      country:"FR",
      type:"exempted",
      rate:0,
      date:"2025-01-01",
      category:"Pharmaceutical products of a kind normally used for health care, prevention of illness and as treatment for medical and veterinary purposes, including products used for contraception and sanitary protection"
    },
    "..."
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/vat?country=FR" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.
  • 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.