The tax election object

A Tax Election is a relationship between a Tax and a specific Company or Employee. It represents a choice about the applicability of that tax.

{
  "id": "txe_abc",
  "tax": "tax_12345",
  "company": "com_12345",
  "employee": "emp_12345", // Only for Employee Tax Elections
  "description": "New York State Tax",
  "payer": "company",
  "jurisdiction": "jur_a0tVPT9vnlUir9LqfB0W",
  "jurisdiction_abbreviation": "NY",
  "exemptible": true,
  "setting": {
    "exempt": true,
    "effective_start": "2024-01-01",
    "effective_end": "2024-12-31"
  },
  "setting_timeline": [
    {
      "exempt": false,
      "effective_start": "1900-01-01",
      "effective_end": "2023-12-31"
    },
    {
      "exempt": true,
      "effective_start": "2024-01-01",
      "effective_end": "2024-12-31"
    },
    {
      "exempt": false,
      "effective_start": "2025-01-01",
      "effective_end": null
    }
  ]
}

Attribute	Description
`id` string	Unique identifier for the Tax Election.
`tax` string	Unique identifier for the Tax.
`company` string	Unique identifier for the Company.
`employee` string	Unique identifier for the Employee (only for Employee Tax Elections).
`description` string	Human-readable description for the Tax.
`payer` string	The payer of the tax (company or employee).
`jurisdiction` string	Unique identifier for the tax's Jurisdiction.
`jurisdiction_abbreviation` string	The abbreviation for the Jurisdiction.
`exemptible` boolean	Indicates whether the `setting` for this Tax can be changed through the API. When `false`, requests to update this Tax Election are rejected with a `validation_error`. To request an exemption for one of these Taxes, contact Check Support. FUTA and state unemployment (SUI) taxes are examples of Taxes that are not exemptible through the API.
`setting` object	The effective setting for the Tax Election.
`setting_timeline` list	The effective dated history of `setting` objects.