---
title: "List tax rates"
method: GET
path: "/v1/taxes/rates"
tags: ["Taxes"]
---

# List tax rates

`GET /v1/taxes/rates`

Retrieve existing custom tax rates.

## Query parameters

- `take` number, nullable
- `skip` number, nullable
- `id` string
- `id__not` string
- `id__isNull` string
- `id__isNotNull` string
- `id__equals` string
- `id__contains` string
- `id__startsWith` string
- `id__endWith` string
- `name` string
- `name__not` string
- `name__isNull` string
- `name__isNotNull` string
- `name__equals` string
- `name__contains` string
- `name__startsWith` string
- `name__endWith` string
- `description` string
- `description__not` string
- `description__isNull` string
- `description__isNotNull` string
- `description__equals` string
- `description__contains` string
- `description__startsWith` string
- `description__endWith` string
- `invoicing_entity_id` string
- `invoicing_entity_id__not` string
- `invoicing_entity_id__isNull` string
- `invoicing_entity_id__isNotNull` string
- `invoicing_entity_id__equals` string
- `invoicing_entity_id__contains` string
- `invoicing_entity_id__startsWith` string
- `invoicing_entity_id__endWith` string

## Response `200`

- PaginatedTaxRate
  - `meta` object, required
    - `total` number, required — Total of existing items.
    - `taken` number, required — Number of items returned.
    - `skipped` number, required — Number of items skipped.
  - `data` TaxRate[], required — List of TaxRate.
    - `id` string, required — Tax rate ID.
    - `name` string, required — Name of the tax rate.
    - `description` string, nullable, required — Internal description of the tax rate.
    - `code` string, required — Tax rate code identifier.
    - `rate` number, required — The percentage rate of the tax.
    - `invoicing_entity_id` string, required — ID of the invoicing entity to which the tax rate is attached.
    - `created_at` string, date-time, required — Tax rate creation date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required — Tax rate last edition date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

---

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