The Tax object

A Tax is a levy that arises when running payroll, like Federal Income Tax, a state's unemployment insurance tax (SUI), or a local levy like a PA borough's Local Services Tax. Each tax carries a jurisdiction for filtering, its payer (whether the money is withheld from the employee or an employer cost), and dating for both the obligation itself and Check's support for calculation, remittance, and/or filing.

{
  "id": "tax_8L3JLfsH4X6dp0maBWfW",
  "label": "Federal Income Tax",
  "jurisdiction": "fed",
  "payer": "employee",
  "supported": true,
  "remittable": true,
  "effective_from": "1900-01-01",
  "effective_to": null
}

Attribute	Description
`id` string	Unique identifier (`tax_` prefix).
`label` string	Human-readable name for display.
`jurisdiction` enum	Lowercase region code (`fed` or lowercased ISO 3166-2:US region code). Used to group and filter other resources. Local taxes use their state's value.
`payer` enum	Whose money pays the tax: `employee` (withheld) or `company` (employer cost)
`supported` boolean	Whether Check calculates and reports (files) this tax. This 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` date \| null	First date (inclusive) the obligation exists. Treat it as an eventually consistent reference as agency information comes in. Very old taxes carry values of `1900-01-01`.
`effective_to` date \| null	Last date (inclusive) the obligation applies; `null` while still in effect.