Skip to main content

​
VAT Rates

Retrieve current VAT rates for all 28 supported countries: all EU 27 member states plus the United Kingdom. Rates include standard, reduced, super-reduced, and zero rates.
VAT rates endpoints are free and unlimited and do not count against your monthly validation quota. Burst rate limiting still applies.

​
List all rates

curl -H "Authorization: Bearer vtly_live_your_api_key" \
  "https://api.vatly.dev/v1/rates"

{
  "data": [
    {
      "country_code": "AT",
      "country_name": "Austria",
      "currency": "EUR",
      "standard_rate": 20,
      "other_rates": [
        { "rate": 13, "type": "reduced" },
        { "rate": 10, "type": "reduced" }
      ],
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "count": 28
  }
}

​
Get rates for a specific country

curl -H "Authorization: Bearer vtly_live_your_api_key" \
  "https://api.vatly.dev/v1/rates/NL"

{
  "data": {
    "country_code": "NL",
    "country_name": "Netherlands",
    "currency": "EUR",
    "standard_rate": 21,
    "other_rates": [
      { "rate": 9, "type": "reduced" }
    ],
    "updated_at": "2026-01-01T00:00:00.000Z"
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}
The country code is case-insensitive: nl, Nl, and NL all work.

​
Supported countries

CodeCountryCurrencyStandard Rate
ATAustriaEUR20%
BEBelgiumEUR21%
BGBulgariaBGN20%
CYCyprusEUR19%
CZCzech RepublicCZK21%
DEGermanyEUR19%
DKDenmarkDKK25%
EEEstoniaEUR22%
ELGreeceEUR24%
ESSpainEUR21%
FIFinlandEUR25.5%
FRFranceEUR20%
GBUnited KingdomGBP20%
HRCroatiaEUR25%
HUHungaryHUF27%
IEIrelandEUR23%
ITItalyEUR22%
LTLithuaniaEUR21%
LULuxembourgEUR17%
LVLatviaEUR21%
MTMaltaEUR18%
NLNetherlandsEUR21%
PLPolandPLN23%
PTPortugalEUR23%
RORomaniaRON19%
SESwedenSEK25%
SISloveniaEUR22%
SKSlovakiaEUR23%

​
Rate types

Each country has a standard_rate and an other_rates array. Rate types include:
  • reduced: Lower rate for essentials (food, books, medicine)
  • super_reduced: Even lower rate available in some countries (e.g. France 2.1%)
  • zero: 0% rate for specific categories (e.g. UK zero-rated goods)

​
Error handling

Unknown country codes return a 404 with a structured error: 
curl -H "Authorization: Bearer vtly_live_your_api_key" \
  "https://api.vatly.dev/v1/rates/XX"

{
  "error": {
    "code": "not_found",
    "message": "No VAT rates found for country code: XX",
    "docs_url": "https://docs.vatly.dev/errors/not_found"
  },
  "meta": {
    "request_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

​
Data freshness

Rates are updated manually when EU or UK governments announce changes (typically 1-2 times per year). The updated_at field shows when each country’s rate data was last refreshed.