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"
}
}| Attribute | Description |
|---|---|
valuestring | (Optional) The value of the setting. |
effective_startYYYY-MM-DD | (Optional) Date when this value starts being effective. Will be set to null if the tax parameter cannot be effective dated. |
created_atdatetime | 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. |
actorobject | (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"
}
}
]
