---
updatedAt: 2026-06-18T18:55:55.000Z
agentTools:
  projectIndex: https://docs.checkhq.com/llms.txt
---

# 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.

```json
{
  "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
    }
  ]
}
```

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Attribute
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        `id`  
        _string_
      </td>

      <td>
        Unique identifier for the Tax Election.
      </td>
    </tr>

    <tr>
      <td>
        `tax`  
        _string_
      </td>

      <td>
        Unique identifier for the Tax.
      </td>
    </tr>

    <tr>
      <td>
        `company`  
        _string_
      </td>

      <td>
        Unique identifier for the Company.
      </td>
    </tr>

    <tr>
      <td>
        `employee`  
        _string_
      </td>

      <td>
        Unique identifier for the Employee (only for Employee Tax Elections).
      </td>
    </tr>

    <tr>
      <td>
        `description`  
        _string_
      </td>

      <td>
        Human-readable description for the Tax.
      </td>
    </tr>

    <tr>
      <td>
        `payer`  
        _string_
      </td>

      <td>
        The payer of the tax (company or employee).
      </td>
    </tr>

    <tr>
      <td>
        `jurisdiction`  
        _string_
      </td>

      <td>
        Unique identifier for the tax's Jurisdiction.
      </td>
    </tr>

    <tr>
      <td>
        `jurisdiction_abbreviation`  
        _string_
      </td>

      <td>
        The abbreviation for the Jurisdiction.
      </td>
    </tr>

    <tr>
      <td>
        `exemptible`  
        _boolean_
      </td>

      <td>
        Indicates whether the Tax is exemptible.
      </td>
    </tr>

    <tr>
      <td>
        `setting`  
        _object_
      </td>

      <td>
        The effective setting for the Tax Election.
      </td>
    </tr>

    <tr>
      <td>
        `setting_timeline`  
        _list_
      </td>

      <td>
        The effective dated history of `setting` objects.
      </td>
    </tr>
  </tbody>
</Table>