---
title: "List taxes"
method: GET
path: "/taxes"
---

# List taxes

`GET /taxes`

Returns the catalog of payroll taxes Check tracks — both taxes Check supports and in-domain taxes it does not support (see [the Tax object](https://docs.checkhq.com/reference/the-tax-object)).

By default the list includes only taxes whose obligation is currently in effect; pass `effective=false` to list repealed or lapsed taxes instead.

Results are ordered with federal taxes first, then by `jurisdiction`, then by `label`. Pages contain 25 results by default and at most 500 (`limit`).

## Query parameters

- `id` string[]
- `jurisdiction` string[]
- `supported` boolean
- `remittable` boolean
- `effective` boolean
- `label_contains` string
- `limit` integer

## Response `200`

200

- object
  - `next` string, nullable — URL of the next page of results, or null if there are no more.
  - `previous` string, nullable — URL of the previous page of results, or null on the first page.
  - `results` object[]
    - `id` string — Unique identifier (`tax_` prefix).
    - `label` string — Human-readable name for display.
    - `jurisdiction` string — Lowercase region code (`fed` or a lowercased ISO 3166-2:US region code). Local taxes use their state's value.
    - `payer` 'employee' | 'company' — Whose money pays the tax: `employee` (withheld) or `company` (employer cost).
    - `supported` boolean, nullable — Whether Check calculates and reports (files) this tax. Does not imply Check remits it — see `remittable`.
    - `remittable` boolean — Whether Check remits this tax to the agency on your behalf. Always `false` when `supported` is `false` (Check can’t remit a tax it doesn’t support); may also be `false` for supported taxes the employer self-remits (e.g. NY SDI paid to a private carrier).
    - `effective_from` string, date, nullable — First date (inclusive) the obligation exists. Very old taxes carry values of `1900-01-01`.
    - `effective_to` string, date, nullable — Last date (inclusive) the obligation applies; `null` while still in effect.

## Other responses

- `400` — 400

---

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