VAT Rates

GET /v1/vat/rates — Look up the current VAT rate for a country and tax class

Endpoint

GET /v1/vat/rates

Required scope: full or read-only

Query Parameters

ParameterTypeRequiredDescription
countrystringYesISO 3166-1 alpha-2 code (e.g., DE, FR)
tax_class_idstringYesTax class identifier (e.g., standard, books)

Example Request

curl "https://api.vat-engine.daily-automations.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

FieldTypeDescription
countrystringISO country code
tax_class_idstringTax class identifier
rate_bpsintegerVAT rate in basis points (1900 = 19.00%)
valid_fromstringStart date of rate validity (RFC 3339)
valid_tostring | nullEnd date of rate validity, or null if currently active