---
title: "List Tax Rates"
method: GET
path: "/v1/accounting/tax-rates"
tags: ["API / Accounting", "Use case / Master data sync", "Use case / Accounting"]
---

# List Tax Rates

`GET /v1/accounting/tax-rates`

## Request

- Base URL: `https://api.qargo.com`
- URL: `https://api.qargo.com/v1/accounting/tax-rates`
- Auth: OAuth 2 (client credentials, token URL `/v1/auth/token`)

Lists tax rates for the tenant, with optional filtering and pagination.

## Query parameters

- `cursor` string, nullable
- `archived` boolean, nullable
- `billing_entity_code` string, nullable
- `code` string, nullable
- `code:in` string, nullable

## Response `200`

Successful Response

- ListTaxRateOutput
  - `next_cursor` string, nullable
  - `items` TaxRateOutput[], required
    - `id` string, uuid, required: Unique identifier of the record in Qargo.
    - `archived` boolean, required: Whether this record has been archived.
    - `name` string, required: Display name of the tax rate.
    - `billing_entity` BillingEntity, required
      - `id` string, uuid, required: Unique identifier of the billing entity in Qargo.
      - `legal_name` string, required: Legal name of the billing entity.
      - `vat_number` string, required: VAT number of the billing entity.
      - `code` string, required: Code of the billing entity.
      - `company_registration_number` string, required: Company registration number of the billing entity.
      - `is_default` boolean: Indicates whether this billing entity is the default one.
    - `percentage` number, required: Tax percentage, e.g. 21.0.
    - `base_percentage` number, nullable: Base percentage before applying customer/transport-specific tax rules.
    - `code` string, required: Code used in the external accounting software.
    - `tax_type` 'VAT' | 'NO_VAT' | 'REVERSE_CHARGE' | 'UK_REVERSE_CHARGE' | 'TRANSIT' | 'CO_CONTRACTING' | 'OTHER', required
    - `invoice_type` 'SALES' | 'SALES_CREDIT_NOTE' | 'PURCHASE' | 'PURCHASE_CREDIT_NOTE', required
    - `description` string, required: Optional description of the tax rate.

## Other responses

- `400`: Bad Request — invalid input or malformed request
- `401`: Unauthorized — missing or invalid authentication credentials
- `403`: Forbidden — insufficient permissions for this operation
- `422`: Validation Error
- `429`: Too Many Requests — rate limit exceeded. See the `Retry-After` header
- `500`: Internal Server Error
- `503`: Service Unavailable — temporarily unable to handle the request

## Changes

- **2026-09-28** `cf0a203f13f4`: 1 warning
  - added the new `UK_REVERSE_CHARGE` enum value to the `items/items/tax_type` response property for the response status `200`
- **2026-09-25** `6abdfcd1a541`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/qargo/apis/qargo-tms-api/changes/v1/accounting/tax-rates/get.md)

---

[API](https://skmtc.dev/qargo/apis/qargo-tms-api.md) · [All operations](https://skmtc.dev/qargo/apis/qargo-tms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qargo/apis/qargo-tms-api/revisions/46db2c329351?raw)