[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
}
]
}