---
title: "Get tax table with rates and values (by tax rate)"
method: GET
path: "/v1/workflows/tax/by-tax-rate/{taxRateId}"
tags: ["Tax eav"]
---

# Get tax table with rates and values (by tax rate)

`GET /v1/workflows/tax/by-tax-rate/{taxRateId}`

## Request

- Base URL: `https://api.finalpos.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finalpos.com/v1/workflows/tax/by-tax-rate/{taxRateId}`
- Auth: API key in header `x-api-key`

Resolves the tax table from a tax rate id (embedded `taxRates.taxRate` on the table, or `taxTableId` on the rate when present). Returns that table, tax rate documents referenced on the table plus the anchor rate, and all tax rate values for those rates, scoped to the API key company.

## Path parameters

- `taxRateId` string, required

## Response `200`

Returns the tax table, tax rates resolved from the table embedded `taxRates` refs, and tax rate values for those rates. Empty arrays when there are no matching rate/value rows.

- object
  - `taxTable` TaxTableResponseDto, required
    - `id` string: Unique identifier for the TaxTable.
    - `createdAt` string, date-time: Timestamp when the TaxTable was created.
    - `updatedAt` string, date-time: Timestamp when the TaxTable was last updated.
    - `companyId` string: Company ID associated with the TaxTable.
    - `source` string: Source of the tax table.
    - `externalId` string: External provider id for the tax table (e.g. the QuickBooks TaxCode Id). Integration correlation key.
    - `name` string: Name of the tax table.
    - `slug` string: Slug identifier for the tax table.
    - `taxRates` object[]: Tax rates applied to the tax table.
    - `isStandard` boolean: Whether this is the standard tax table.
  - `taxRates` TaxRateResponseDto[], required
    - `id` string: Unique identifier for the TaxRate.
    - `createdAt` string, date-time: Timestamp when the TaxRate was created.
    - `updatedAt` string, date-time: Timestamp when the TaxRate was last updated.
    - `companyId` string: Company ID associated with the TaxRate.
    - `name` string: Name of the tax rate.
    - `externalId` string: External provider id for the tax rate (e.g. the QuickBooks TaxRate Id). Integration correlation key.
    - `source` string: Origin of the tax rate — the integration provider that created it.
  - `taxRateValues` TaxRateValueResponseDto[], required
    - `id` string: Unique identifier for the TaxRateValue.
    - `createdAt` string, date-time: Timestamp when the TaxRateValue was created.
    - `updatedAt` string, date-time: Timestamp when the TaxRateValue was last updated.
    - `companyId` string: Company ID associated with the TaxRateValue.
    - `taxRateId` string: Tax rate ID this value belongs to.
    - `outletId` string: Outlet ID this tax rate value applies to.
    - `value` number: Tax rate value (percentage).

## Other responses

- `400`: Bad request. Returns validation errors or other request-related errors.
- `404`: The tax table was not found for this company.

---

[API](https://skmtc.dev/finalpos/apis/final-pos-public-api.md) · [All operations](https://skmtc.dev/finalpos/apis/final-pos-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finalpos/apis/final-pos-public-api/revisions/6a6842dcb479?raw)