---
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`

## Request

- Base URL: `https://public.letsweel.com`
- URL: `https://public.letsweel.com/v1/businesses/{client_id}/tax-rates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/letsweel/apis/weel-openapi/docs/v1/businesses/:client_id/tax-rates/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/letsweel/apis/weel-openapi.md) - [All operations](https://skmtc.dev/letsweel/apis/weel-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/letsweel/apis/weel-openapi/revisions/b1e30cdf67f3?raw)