Get

[POST] .../v1/taxvat/get

Returns VAT rates. Use this method to read VAT rates before assigning a tax rate to items, documents or POS configuration. The response returns active non-deleted VAT rates with id, percentage value, display name, enabled flag and last update time. The request body is required and supports filters for id and enabled. System VAT rate id=1 uses value -1 to represent "Without VAT" and its name is translated for the current request language. The caller must have VAT select permission. Missing body, denied permission, invalid filters, cache errors and database errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.

Filterable Fields

Field Type Description
enabled bool Filter by VAT rate availability flag.
id int VAT rate IDs.

Request Example

{
  "filters": [
    {
      "Field": "enabled",
      "Operator": "Equal",
      "Value": "true"
    }
  ]
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Array of TaxVat Result array.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 1,
      "value": -1,
      "name": "Without VAT",
      "enabled": true,
      "last_update": 1672041613
    },
    {
      "id": 4,
      "value": 12,
      "name": "12%",
      "enabled": true,
      "last_update": 1672188628
    }
  ]
}