---
title: "Get a specific employee's tax parameter setting"
method: GET
path: "/employee_tax_params/{employee_id}/settings/{tax_param_id}"
---

# Get a specific employee's tax parameter setting

`GET /employee_tax_params/{employee_id}/settings/{tax_param_id}`

## Request

- Base URL: `https://sandbox.checkhq.com`
- URL: `https://sandbox.checkhq.com/employee_tax_params/{employee_id}/settings/{tax_param_id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkhq/apis/check-api/docs/employee_tax_params/:employee_id/settings/:tax_param_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get an employee’s tax parameter detail. The top-level `value` and `effective_start` are the value in force on `as_of`, today by default: what applies when. `settings` lists every recorded value that has not been deleted, newest `effective_start` first and, within one `effective_start`, newest `created_at` first: what changed. 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, including earlier values replaced by a form submission. For a tax parameter that is not effective dated, `value` is the current value and `effective_start` is `null`. Each entry in `settings` carries an `actor` object naming the `party` that wrote that value: `check`, `partner`, `company`, or `employee`. `party` classifies the actor, not the setting’s subject, so a company user who edits an employee-scoped setting reads as `company`. `actor` is `null` when the attribution cannot be recovered.

## Path parameters

- `employee_id` string, required
- `tax_param_id` string, required

## Query parameters

- `as_of` string, date

## Response `200`

200

- object
  - `id` string
  - `jurisdiction` string
  - `applied_for` unknown
  - `value` string, nullable: The value in force on `as_of`.
  - `effective_start` string, date, nullable: The `effective_start` of the value in force on `as_of`. `null` for a tax parameter that is not effective dated.
  - `settings` object[]: Every recorded value that has not been deleted, newest `effective_start` first and, within one `effective_start`, newest `created_at` first.
    - `value` string
    - `effective_start` string, date
    - `created_at` string, date-time: When this value was written. For one `effective_start`, the entry with the latest `created_at` is the value in force from that date.
    - `actor` object, nullable
      - `party` 'check' | 'partner' | 'company' | 'employee'

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `5a54f5eb888b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/employee_tax_params/:employee_id/settings/:tax_param_id/get.md)

---

[API](https://skmtc.dev/checkhq/apis/check-api.md) - [All operations](https://skmtc.dev/checkhq/apis/check-api/llms.txt) - [OpenAPI document](https://skmtc.dev/checkhq/apis/check-api/revisions/5a54f5eb888b?raw)