---
title: "List tax rates"
method: GET
path: "/api/v1/taxRates/{countryCode}"
tags: ["Tax Rate"]
---

# List tax rates

`GET /api/v1/taxRates/{countryCode}`

This endpoint returns the tax rate for a given country code. The country code is a two-letter ISO 3166-1 alpha-2 code. The response is a list of applicable tax rates for the given country code.
To get a more granular response you can use the query parameters to filter the response, for example by product or project.

The applicable tax rate is determined in the following order:
1. If a custom tax rate is defined for the product, it is returned.
2. If a tax rate is defined in the taxRates module for that country, it is returned.
3. If a tax rate is defined in the taxRates module for the project, or a generic tax Rate without country or project it is returned.
4. If a tax rate is defined for the applicable project it is returned.
5. If a tax rate is defined for the system it is returned.
6. If no tax rate is defined anywhere we will return an empty list.

To see which step was used to determine the tax rate, the source field is returned in the response.

## Path parameters

- `countryCode` string, required

## Query parameters

- `filter` object[]
  - `key` 'productId' | 'date' | 'type' | 'projectId'
  - `op` 'equals' | 'notEquals' | 'in' | 'notIn' | 'exactlyIn' | 'allIn' | 'allNotIn' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'lessThan' | 'is' | 'lessThanOrEquals' | 'greaterThanOrEquals'
  - `value` union
    - string — Used for the operations 'equals', 'notEquals', 'contains', 'notContains', 'startsWith', 'endsWith' and 'is'.
    - string[] — Used for the operations 'in', 'notIn', 'exactlyIn', 'allIn' and 'allNotIn'.
- `page` object
  - `number` string, required — Page number should be an integer greater than or equal to 1
  - `size` string, required — Page size should usually be an integer between 10 and 50.

## Response `200`

Operation completed successfully.

- object
  - `data` object[]
    - `rate` string — Tax rate value in percent
    - `type` string — Tax rate type: standard, reduced or custom
    - `date` string, date — Requested date or current date if no date was specified
    - `name` string, nullable — Tax rate's designation
    - `product` object, nullable — Nullable reference to another resource
      - `id` string, required — Resource identifier.
    - `project` object, nullable — Nullable reference to another resource
      - `id` string, required — Resource identifier.
    - `source` string — Informs how was the tax rate determined
  - `extra` object
    - `totalCount` integer, required — the total count of all items
    - `page` object, required — The pagination object containing the current page number and size
      - `number` integer, required — The current page number
      - `size` integer, required — The size of the pages

## Other responses

- `400` — IETF RFC 9457 Problem API compliant response
- `401` — Unable to authenticate the client
- `403` — Unable to authorize the client
- `406` — Requested resource representation does not exist.
- `429` — Too many API calls made.

---

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