---
title: "List the master VAT catalog used by Klara Accounting."
method: GET
path: "/core/latest/accounting/master-vats"
tags: ["Accounting"]
deprecated: true
---

# List the master VAT catalog used by Klara Accounting.

`GET /core/latest/accounting/master-vats`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/accounting/master-vats`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

> **Deprecated.**

This operation remains available until <b>2027-08-14</b> and is removed after that date. Use <code>GET /core/v1/accounting/master-vats</code> instead.<br/><br/>Returns the global master VAT catalog — the table of supported VAT rates with their validity ranges and translated labels. The downstream handler is a dispatcher driven by the query string: when <code>code</code> is non-blank only rows whose <code>vatCode</code> matches one of the semicolon-separated codes are returned (and when combined with <code>current-period=true</code>, only the ones valid today); otherwise when <code>default-vat=true</code> only the company-default rows are returned; otherwise the full catalog is returned, ordered by rate ascending, optionally paginated via <code>offset</code> / <code>limit</code>. Pagination is honoured only on the full-catalog branch — it is silently ignored when <code>code</code> or <code>default-vat</code> is set. The endpoint is a pure read and idempotent. Requires a bearer token whose principal carries the <code>ACCOUNTING_GET_MASTER_VAT</code> permission.

## Query parameters

- `code` string
- `current-period` boolean
- `default-vat` boolean
- `includeHiddenVatCase` boolean
- `limit` integer
- `offset` integer

## Response `200`

Array of master VAT rows matching the filters.

- PublicApiMasterVat[]
  - `id` integer: Internal id of the master VAT row.
  - `vatCode` string: Short numeric VAT code as configured in the Klara accounting plan.
  - `rate` number: VAT rate as a percentage value (8.10 means 8.10 %).
  - `validFrom` string, date: Inclusive start date of the validity range (ISO yyyy-MM-dd). May be null when open-ended.
  - `validTo` string, date: Inclusive end date of the validity range (ISO yyyy-MM-dd). May be null when open-ended.
  - `defaultVat` boolean: True when the row is one of the company-default VAT entries.
  - `masterVatMulties` PublicApiMasterVatMulti[]: Localized labels keyed by language tag.
    - `id` integer: Internal id of the translation row.
    - `language` string: Language tag of the translation (ISO 639-1).
    - `description` string: Human-readable VAT description in the matching language.
  - `referenceVatCaseId` string: Optional reference to a hidden VAT case id not directly mapped to a master VAT.
  - `createDate` string, date-time: Timestamp when the row was created (ISO yyyy-MM-dd'T'HH:mm:ss).
  - `updateDate` string, date-time: Timestamp of the last update (ISO yyyy-MM-dd'T'HH:mm:ss).

## Other responses

- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `410`: Gone. This operation is removed after 2027-08-14; every call after that date answers 410. Use <code>GET /core/v1/accounting/master-vats</code> instead.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `500`: Something went wrong on our side while processing the request. Please kindly contact our support.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

[API](https://skmtc.dev/klara/apis/klara-public-api.md) · [All operations](https://skmtc.dev/klara/apis/klara-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klara/apis/klara-public-api/revisions/490b1a879fc2?raw)