---
title: "List of tax rates"
method: GET
path: "/api/v1/tax-rates"
tags: ["TaxRate"]
---

# List of tax rates

`GET /api/v1/tax-rates`

Returns the list of tax rates

## Query parameters

- `page` number
- `limit` number
- `createdAt` DateFilterDto
  - `isnull` boolean — Returns null values
  - `notnull` boolean — Returns not null values
  - `gt` string, date-time — Returns values greater than the given date
  - `gte` string, date-time — Returns values greater than or equal to the given date
  - `lt` string, date-time — Returns values less than the given date
  - `lte` string, date-time — Returns values less than or equal to the given date
- `ids` string
- `isActive` boolean

## Response `200`

- object
  - `page` number, required — Page number. Starts from 1
  - `limit` number, required — Number of items per page
  - `count` number, required
  - `hasMore` boolean, required
  - `query` PaginationFilterDto
    - `page` number — Page number. Starts from 1
    - `limit` number — Number of items per page
    - `createdAt` DateFilterDto
      - `isnull` boolean — Returns null values
      - `notnull` boolean — Returns not null values
      - `gt` string, date-time — Returns values greater than the given date
      - `gte` string, date-time — Returns values greater than or equal to the given date
      - `lt` string, date-time — Returns values less than the given date
      - `lte` string, date-time — Returns values less than or equal to the given date
  - `data` object[], required
    - `id` string, required
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `name` string, required — The name of the tax rate.
    - `description` string — The description of the tax rate.
    - `country` string — The country of the tax rate.
    - `percentage` number, required — Percent that will be added to subtotal as a tax.
    - `type` 'exclusive' | 'inclusive', required
    - `isActive` boolean — Whether the tax rate is currently active
    - `metadata` object — The metadata of the tax rate

## Other responses

- `500`

---

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