Tax Classes

Endpoints

GET /v1/tax-classes
GET /v1/tax-classes/{id}

Authentication: Public (no API key required)

List Tax Classes

Query Parameters

Parameter	Type	Required	Description
`q`	`string`	No	Free-text search across id, name and description (max 120 chars)
`group`	`string`	No	Filter by group slug (e.g., `books_publications`)
`tag`	`string`	No	Filter by tag slug (e.g., `publications`)
`country`	`string`	No	ISO alpha-2 code — includes a `preview_rate_bps` for that country
`at`	`string`	No	Effective date (RFC 3339 or `YYYY-MM-DD`). Defaults to current UTC

Examples

List all tax classes

curl https://api.vat-engine.daily-automations.app/v1/tax-classes

Search by keyword

curl "https://api.vat-engine.daily-automations.app/v1/tax-classes?q=book"

Filter by group

curl "https://api.vat-engine.daily-automations.app/v1/tax-classes?group=books_publications"

Filter by tag with a country preview rate

curl "https://api.vat-engine.daily-automations.app/v1/tax-classes?tag=publications&country=DE"

Response

{
  "items": [
    {
      "id": "books",
      "name": "Books",
      "description": "Physical and digital books",
      "source": "TEDB",
      "group_slug": "books_publications",
      "group_name": "Books & Publications",
      "tags": ["publications"],
      "preview_rate_bps": 700
    }
  ]
}

Response Fields

Field	Type	Description
`id`	`string`	Tax class identifier
`name`	`string`	Human-readable name
`description`	`string`	Short description
`source`	`string`	Data source (e.g., `TEDB`)
`group_slug`	`string`	Slug of the group this class belongs to
`group_name`	`string`	Human-readable group name
`tags`	`string[]`	Tag slugs for finer categorization
`preview_rate_bps`	`integer \| null`	VAT rate in basis points for the requested `country` (if provided)

Get a Tax Class

Returns a single tax class with active country rates.

Path Parameters

Parameter	Type	Required	Description
`id`	`string`	Yes	Tax class slug (e.g., `books`)

Query Parameters

Parameter	Type	Required	Description
`country`	`string`	No	ISO alpha-2 code — limits rates to that country
`at`	`string`	No	Effective date (RFC 3339 or `YYYY-MM-DD`). Defaults to current UTC

Example

curl "https://api.vat-engine.daily-automations.app/v1/tax-classes/books?country=DE"

Response

{
  "id": "books",
  "name": "Books",
  "description": "Physical and digital books",
  "source": "TEDB",
  "group_slug": "books_publications",
  "group_name": "Books & Publications",
  "tags": ["publications"],
  "rates": [
    {
      "country": "DE",
      "rate_bps": 700,
      "valid_from": "2026-01-01T00:00:00Z",
      "valid_to": null
    }
  ]
}

Available Tax Classes

VAT Engine supports 37 tax classes organized into groups:

Group	Examples
General	`standard`
Food & Beverages	`food`, `food_restaurant`
Health & Pharmaceutical	`pharma`, `medical_devices`, `medical_dental`
Books & Publications	`books`, `newspapers`, `periodicals`
Culture & Entertainment	`admission_cultural`, `admission_sports`, `broadcasting`
Accommodation & Transport	`accommodation`, `transport_passengers`
Energy & Utilities	`electricity`, `natural_gas`, `district_heating`, `water_supply`
Agriculture	`agricultural_inputs`
Children	`children_clothing`, `children_car_seats`
Domestic & Local Services	`domestic_care`, `hairdressing`, `waste_collection`, `funeral_services`
Housing & Renovation	`renovation_housing`, `social_housing`
Repair Services	`repair_clothing`, `repair_shoes`, `repair_bicycles`, `bicycles`
Art & Collectibles	`art_original`, `art_collectibles`
Plants	`plants_flowers`

On this page