Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vatly.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
VAT Rates

Retrieve current VAT rates for all 31 supported countries: all EU 27 member states, the United Kingdom, Switzerland, Liechtenstein, and Norway. 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": 31
  }
}

​
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%
CHSwitzerlandCHF8.1%
CYCyprusEUR19%
CZCzech RepublicCZK21%
DEGermanyEUR19%
DKDenmarkDKK25%
EEEstoniaEUR22%
ELGreeceEUR24%
ESSpainEUR21%
FIFinlandEUR25.5%
FRFranceEUR20%
GBUnited KingdomGBP20%
HRCroatiaEUR25%
HUHungaryHUF27%
IEIrelandEUR23%
ITItalyEUR22%
LILiechtensteinCHF8.1%
LTLithuaniaEUR21%
LULuxembourgEUR17%
LVLatviaEUR21%
MTMaltaEUR18%
NLNetherlandsEUR21%
NONorwayNOK25%
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)

​
Non-EU rate details

  • Switzerland: 8.1% standard, 3.8% reduced (accommodation), 2.6% reduced (food, books, medicines)
  • Liechtenstein: Same rates as Switzerland (shared VAT territory)
  • Norway: 25% standard, 15% reduced (food), 12% reduced (transport, accommodation)

​
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 governments announce changes (typically 1-2 times per year). The updated_at field shows when each country’s rate data was last refreshed.