BizKitHub
DocsAPI ReferenceVat Rate/bff/vat-rate/list
getVat RateAdmin BFF

/bff/vat-rate/list

Returns the time-bounded VAT rate master table. Filterable by country and "valid on this date". Use without validOn for the admin management screen, with validOn for invoice issue dropdowns.

VAT rategetBffVat-rateList

Parameters

2 query

Query parameters

· 2
countryCodestringOptional

ISO 3166-1 alpha-2 country code filter (e.g. "CZ").

ExampleCZ
validOnstringOptional

ISO date (YYYY-MM-DD). When provided, only rates valid on that day are returned — use this when populating a "VAT rate" dropdown for a specific invoice issue date.

Example2026-05-04

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
idnumberRequired
codestringRequired

Logical code (e.g. "CZ_BASIC", "CZ_REDUCED", "CZ_REVERSE").

countryCodestringRequired
ratePercentstringRequired

Numeric percent as decimal string (e.g. "21.00").

validFromstringRequired

ISO date (inclusive).

validTostring | nullRequired

ISO date (exclusive). NULL = ongoing.

One of 2:
Variant 1
string
Variant 2
null
isDefaultbooleanRequired
isReverseChargebooleanRequired

When true, the rate is 0 % with the EU reverse-charge note.

labelCsstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
labelEnstring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
displayOrdernumberRequired

UI sort key (lower first).

Response example

application/json
{
  "items": [
    {
      "id": 0,
      "code": "example_code",
      "countryCode": "example_countryCode",
      "ratePercent": "example_ratePercent",
      "validFrom": "example_validFrom",
      "isDefault": false,
      "isReverseCharge": false,
      "displayOrder": 0
    }
  ]
}

Request example

GET /bff/vat-rate/list

get
curl -X GET "https://api.bizkithub.com/bff/vat-rate/list?countryCode=CZ&validOn=2026-05-04" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key