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_12345",
  "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 Tax is exemptible.

setting
object

The effective setting for the Tax Election.

setting_timeline
list

The effective dated history of setting objects.