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

# List taxes

`GET /taxes`

Returns a paginated list of taxes.

🔒 Requires: `taxes:read` scope

## Query parameters

- `after` integer
- `before` integer
- `page_size` integer

## Response `200`

- TaxCollection
  - `data` Tax[], required — An array of tax objects.
    - `deleted_at` string, nullable, required — The deletion timestamp.
    - `display_name` string, required — The name of the tax used for display.
    - `id` string, uuid, required — Auto-generated object ID.
    - `is_default` boolean, required — Indicates whether the tax is used as the default one.
    - `name` string — The name of the tax.
    - `rates` TaxRate[]
      - `display_name` string, required — The name of the tax rate used for display.
      - `id` string, uuid, required — Auto-generated object ID.
      - `name` string, required — The name of the tax rate.
      - `rate` number, double, required — Tax rate value. `0.1 = 10%`.
      - `rules` RateRule[] — Rules that apply to the rate for tax exclusive outlets.
        - `tax_code` 'vend_clothing_footwear', required — Label assigned to a product which indicates the tax obligation.
        - `type` 'threshold', required — Type of rule to apply.
        - `value` number — An optional value that can be used for the rule.
    - `version` integer, required — Auto-incrementing object version number.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/revisions/72d4ceb46dbb/schema)