---
title: "Get a specific company's tax parameter setting"
method: GET
path: "/company_tax_params/{company_id}/settings/{tax_param_id}"
---

# Get a specific company's tax parameter setting

`GET /company_tax_params/{company_id}/settings/{tax_param_id}`

## Request

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

Get a company’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

- `company_id` string, required
- `tax_param_id` string, required

## Query parameters

- `as_of` string, date

## Response `200`

200

## Other responses

- `400`: 400

## Changes

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

[Operation history](https://skmtc.dev/checkhq/apis/check-api/changes/company_tax_params/:company_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)