---
title: "List tax rates"
method: GET
path: "/v1/businesses/{client_id}/tax-rates"
tags: ["Tax Rates"]
---

# List tax rates

`GET /v1/businesses/{client_id}/tax-rates`

Returns a paginated list of tax rates for the given business, ordered by name.

For businesses with a connected accounting integration (Xero, MYOB, NetSuite, QuickBooks, Business Central), returns the tax rates synced from that integration. Otherwise, returns the business's own manually configured tax rates. Soft-deleted tax rates are excluded.

> **Beta:** This endpoint is in beta and is being rolled out progressively. If tax rates are not yet enabled for your business, the endpoint returns an empty `results` array.

## Path parameters

- `client_id` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

OK

- TaxRateListResponse
  - `count` integer — Total number of tax rates.
  - `next` string, nullable — Pagination cursor for the next page.
  - `previous` string, nullable — Pagination cursor for the previous page.
  - `results` TaxRate[]
    - `id` string, uuid — The ID of the tax rate.
    - `name` string — The name of the tax rate.
    - `rate` number — The tax rate as a decimal fraction.
    - `code` string, nullable — The tax rate code.
    - `is_default_for` 'DOMESTIC' | 'INTERNATIONAL' | 'BOTH' | 'NONE' — Which transaction types the tax rate is the default for.
    - `is_enabled` boolean — Whether the tax rate is enabled.
    - `source` 'WEEL' | 'MANUAL' | 'ASP' — The source of the tax rate.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/letsweel/apis/weel-openapi.md) · [All operations](https://skmtc.net/letsweel/apis/weel-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/letsweel/weel-openapi/versions/55da5fa350fb/schema)