v1
latestOpenAPI 3.1.02026-07-241642423.7 KBList 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).
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
Tax IDs to look up, for batch lookups. Repeat the parameter to provide multiple values (max 500 per request).
Jurisdictions to filter to, as lowercase region codes (e.g. fed, ny, pa). A state's code includes its state and local taxes. Repeat the parameter to provide multiple values.
Filter by whether Check calculates and reports (files) the tax. Use supported=false to find in-domain taxes Check does not support.
Filter by whether Check remits the tax to the agency on your behalf. Because remittance implies support, remittable=true returns a subset of supported=true.
Filter by whether the tax obligation is in effect as of today. When omitted, the list includes only currently effective taxes.
Case-insensitive substring match on the tax label. Useful for looking up local taxes by name.
Number of results per page (default 25, max 500).
Response
200
Example response
{
"results": [
{
"id": "tax_8L3JLfsH4X6dp0maBWfW",
"label": "Federal Income Tax",
"jurisdiction": "fed",
"payer": "employee",
"supported": true,
"remittable": true,
"effective_from": "1900-01-01"
}
]
}