EU BTW-tarieven API — actuele btw-percentages voor alle 27 EU-lidstaten inclusief GB, NO en CH. Voor Nederland een volledige categorie-uitsplitsing.

GET /v1/finance/vat-rates

Returns the current VAT rates for any EU member state plus GB, NO, and CH. For the Netherlands, a full category breakdown (~24 categories) is included. For all other countries, standard and reduced rates are returned.

The data is embedded and requires no external API call — responses are instant.

Request parameters

Parameter	Type	Required	Description
`country`	string	✓	ISO alpha-2 country code, e.g. `NL`, `DE`, `BE`, `FR`

Example request

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.omnizoek.nl/v1/finance/vat-rates?country=NL"

Example response — NL (with category detail)

{
  "country": "NL",
  "currency": "EUR",
  "standard_rate": 21.0,
  "reduced_rates": [9.0],
  "zero_rate": true,
  "categories": [
    { "name": "food", "description": "Food products for human consumption (general)", "rate": 9.0, "examples": ["vegetables", "fruit", "bread"] },
    { "name": "restaurants", "description": "Restaurant and catering services", "rate": 9.0, "examples": ["dine-in", "takeaway", "catering"] },
    { "name": "software_saas", "description": "Software and SaaS subscriptions", "rate": 21.0, "examples": ["ERP software", "cloud services"] },
    { "name": "books_digital", "description": "E-books and digital publications", "rate": 9.0, "examples": ["e-books", "online newspapers"] }
  ],
  "effective_date": "2012-10-01",
  "source": "Rijksoverheid (NL) / European Commission TEDB",
  "note": null
}

Example response — DE (headline only)

{
  "country": "DE",
  "currency": "EUR",
  "standard_rate": 19.0,
  "reduced_rates": [7.0],
  "zero_rate": false,
  "categories": [],
  "effective_date": "2021-01-01",
  "source": "European Commission TEDB",
  "note": "Category-level detail available for NL only."
}

Response fields

Field	Type	Description
`country`	string	ISO alpha-2 country code
`currency`	string	Local currency
`standard_rate`	number	Standard (high) VAT rate in percent
`reduced_rates`	array	Reduced rate(s) in percent
`zero_rate`	boolean	`true` if a 0% rate exists for certain goods/services
`categories`	array	Per-category breakdown (NL only; empty for other countries)
`effective_date`	string	Date the current rates took effect (YYYY-MM-DD)
`source`	string	Data source attribution
`note`	string \| null	Any applicable caveat

Category item fields

Field	Type	Description
`name`	string	Machine-readable key, e.g. `food`, `pharma`, `software_saas`
`description`	string	Human-readable category label
`rate`	number	Applicable VAT rate in percent
`examples`	array	Example goods/services in this category

Supported countries

All 27 EU member states plus GB, NO, CH.

Error responses

Status	Cause
`400`	Unknown country code

BTW-tarieven (EU)