---
title: "List tax rates"
method: GET
path: "/tax-rates/"
tags: ["Tax Rates"]
---

# List tax rates

`GET /tax-rates/`

Endpoint for retrieving a list of tax rates.

## Query parameters

- `created_ts_after` string, date-time
- `created_ts_before` string, date-time
- `external_id` string
- `modified_ts_after` string, date-time
- `modified_ts_before` string, date-time
- `page` integer
- `page_size` integer
- `tax_type` 'OUT_OF_SCOPE' | 'PURCHASES' | 'REVERSE_CHARGE' | 'SALES' | '__null__'

## Response `200`

- PaginatedTaxRateList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` TaxRate[], required
    - `created_ts` string, date-time, required — The timestamp in UTC when the tax rate was created
    - `description` string — The tax rate description. This field provides additional details about the tax rate.
    - `external_id` string — External identifier for the tax rate.
    - `friendly_name` string, required — The tax rate friendly name. This is a more user-friendly version of the name, typically used for display purposes.
    - `id` string, required — The unique identifier of the tax rate object. This field is read-only.
    - `legacy_id` string, required — [Deprecated] The legacy identifier of the tax rate.
    - `modified_ts` string, date-time, required — The timestamp in UTC when the tax rate was last modified
    - `name` string, required — The tax rate name. This should be a concise identifier for the tax rate.
    - `rate` number, double, required — The numerical value of the tax rate. This is represented as a decimal with up to 6 decimal places.
    - `tax_type` 'SALES' | 'PURCHASES' | 'REVERSE_CHARGE' | 'OUT_OF_SCOPE', required — * `SALES` - Sales * `PURCHASES` - Purchases * `REVERSE_CHARGE` - Reverse Charge * `OUT_OF_SCOPE` - Out of Scope Full information for [TaxTypeEnum](taxtypeenum)

---

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