/bff/vat-rate/resolve

Returns the single rate that was valid on date for the given country and logical code. Throws when no rate matches (admin must add a record to core__vat_rate). Use this when populating a VAT field on an invoice item — the date is the invoice's taxable supply date, not "today".

VAT rategetBffVat-rateResolve

Parameters

3 query

Query parameters

· 3

codestringRequired

Logical VAT rate code, e.g. "CZ_BASIC".

ExampleCZ_BASIC

countryCodestringRequired

ISO 3166-1 alpha-2 country code.

ExampleCZ

datestringRequired

ISO date the rate must be valid on (taxable supply date of the invoice).

Example2023-12-31

Response schema

1 status code documented

200Success

idnumberRequired

codestringRequired

countryCodestringRequired

ratePercentnumberRequired

Numeric percent (e.g., 21 for "21 %", 12 for the post-2024 reduced rate).

validFromstringRequired

validTostring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

isReverseChargebooleanRequired

labelCsstring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

labelEnstring | nullRequired

One of 2:

Variant 1

string

Variant 2

null

Response example

application/json

{
  "id": 0,
  "code": "example_code",
  "countryCode": "example_countryCode",
  "ratePercent": 0,
  "validFrom": "example_validFrom",
  "isReverseCharge": false
}

Request example

GET /bff/vat-rate/resolve

get

curl -X GET "https://api.bizkithub.com/bff/vat-rate/resolve?code=CZ_BASIC&countryCode=CZ&date=2023-12-31" \
  -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