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/rates

Required 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, legacy windows can reflect when a change was applied and are not guaranteed to prove the legal applicability interval. Where an approved immutable TEDB version covers the legal date, VAT Engine selects from that complete reviewed version and fails closed if its matrix is incomplete. This endpoint does not accept a rate-version, knowledge-time, or calculator override and never falls back from an invalid caller selector. Exact replay instead uses the server-owned sealed evidence already attached to the original calculation.