---
title: "Get vat codes"
method: GET
path: "/consumers/{consumer_id}/accounting/vat-codes"
tags: ["Accounting", "VAT codes"]
---

# Get vat codes

`GET /consumers/{consumer_id}/accounting/vat-codes`

Get vat codes existing in the accounting system

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `folder_id` string, nullable

## Response `200`

Successful Response

- ChiftPageAccountingVatCode
  - `items` AccountingVatCode[], required
    - `id` string, required — Unique id of the VAT Code instance in the accounting system.
    - `code` string, nullable — Short code (sometimes also used as id) for the VAT code, as defined in the accounting system. This code is typically used for internal referencing, mapping, or selection of VAT codes
    - `active` boolean, nullable — Flag indicating whether the vat code is active. If True, the vat code is active and can be used in entries/invoices. If False, the vat code is inactive and cannot be used in entries/invoices.
    - `label` string, required — Label of the VAT code as it appears in the accounting system. This is the human-readable name used to identify the VAT code.
    - `scope` 'nat' | 'eu' | 'int' | 'unknown'
    - `rate` number, required — VAT rate associated with the VAT code. This is the percentage rate applied to the amount when this VAT code is used.
    - `type` 'sale' | 'purchase' | 'both' | 'unknown', required
    - `deductible_account` string, nullable — Ledger account number used for the deductible part of the VAT code. This is typically used for purchase transactions where VAT can be deducted.
    - `payable_account` string, nullable — Ledger account number used for the payable part of the VAT code. This is typically used for sales transactions where VAT is collected from customers.
    - `reversed` boolean, nullable — Indicates whether the VAT code is reversed. A reversed VAT code is used in specific scenarios, such as reverse charge mechanisms, where the responsibility for reporting VAT shifts from the seller to the buyer.
    - `withholding_tax` boolean, nullable — Indicates whether the VAT code is a withholding tax. This is used to indicate that the VAT code is a withholding tax and should be treated as such.
    - `country` string, nullable — Country of the VAT code. This is the ISO 3166-1 code of the country.
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/versions/b5f1214a482a/schema)