VAT Rates
Reference for GET /v1/vat/rates, including country and tax-class parameters, recorded-window lookups by date, and example rate responses.
Endpoint
GET /v1/vat/ratesRequired scope: full or read-only
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
country | string | Yes | ISO 3166-1 alpha-2 code (e.g., DE, FR) |
tax_class_id | string | Yes | Tax class identifier (e.g., standard, books) |
at | string | No | Recorded-window lookup time in RFC 3339 or YYYY-MM-DD format. Defaults to the current time. |
Example Request
curl "https://api.vat-engine.app/v1/vat/rates?country=DE&tax_class_id=standard" \-H "X-API-Key: YOUR_API_KEY"Response
{
"country": "DE",
"tax_class_id": "standard",
"rate_bps": 1900,
"valid_from": "2026-01-01T00:00:00Z",
"valid_to": null
}Response Fields
| Field | Type | Description |
|---|---|---|
country | string | ISO country code |
tax_class_id | string | Tax class identifier |
rate_bps | integer | VAT rate in basis points (1900 = 19.00%) |
valid_from | string | Start of the recorded lookup window (RFC 3339); not yet guaranteed to be the legal applicability date |
valid_to | string | null | End of the recorded lookup window, or null if currently active |
The at parameter selects from recorded/imported lookup windows. For current live TEDB updates,
those windows can reflect when a change was applied and are not guaranteed to prove the legal
applicability interval. Current responses also do not pin the exact TEDB snapshot that produced
a row. Source-supported legal dates, immutable rate-data versions, source fingerprints,
data_as_of selection, and exact replay are planned.