Tax parameter setting value

Represents one recorded value in a tax parameter setting history.

Each object in a tax parameter detail's settings list represents one recorded value for that parameter: what changed. The list holds every recorded value that has not been deleted, newest effective_start first and, within one effective_start, newest created_at first. The top-level value and effective_start on the tax parameter detail are the value in force on as_of: what applies when.

A tax parameter written more than once with the same effective_start lists every write. The entry with the latest created_at for an effective_start is the value in force from that date, and each earlier entry for that date was replaced at the created_at of the entry listed above it. Deleted values are not listed. A form submission deletes a tax parameter's earlier values, so a tax parameter last set through a form lists one entry.

{
  "value": "M",
  "effective_start": "2021-03-15",
  "created_at": "2021-03-16T10:41:27.385220Z",
  "actor": {
    "party": "employee"
  }
}
AttributeDescription
value
string
(Optional) The value of the setting.
effective_start
YYYY-MM-DD
(Optional) Date when this value starts being effective. Will be set to null if the tax parameter cannot be effective dated.
created_at
datetime
ISO 8601 UTC timestamp when Check recorded this value. For one effective_start, the entry with the latest created_at is the value in force from that date.
actor
object
(Optional) Who wrote this value. null when attribution cannot be recovered. See Tax parameter setting actor.

In this settings list, the employee changed the value effective 2021-03-15 from S to M. M is in force from 2021-03-15, and S is in force from 2020-01-01 until then.

[
  {
    "value": "M",
    "effective_start": "2021-03-15",
    "created_at": "2021-03-16T10:41:27.385220Z",
    "actor": {
      "party": "employee"
    }
  },
  {
    "value": "S",
    "effective_start": "2021-03-15",
    "created_at": "2021-03-12T17:08:54.672901Z",
    "actor": {
      "party": "employee"
    }
  },
  {
    "value": "S",
    "effective_start": "2020-01-01",
    "created_at": "2019-12-18T21:30:06.017734Z",
    "actor": {
      "party": "company"
    }
  }
]