---
title: "Retrieve a tax configuration"
method: GET
path: "/shop/tax-configurations/{taxConfigurationId}"
tags: ["TaxConfigurations"]
---

# Retrieve a tax configuration

`GET /shop/tax-configurations/{taxConfigurationId}`

Retrieve a single tax configuration by ID. The response includes the
configuration's name, optional description, and the full set of rate
sets that apply to it — useful for surfacing the active tax rules in
a back-office editor, or for previewing what rates will be applied
before testing a calculation against `/calculate`.

## Response `200`

A single tax configuration.

- object
  - `data` TaxConfiguration, required
    - `id` string, mongo-id, required — The ID of the tax configuration.
    - `name` string, required — A name for the tax configuration.
    - `description` string, nullable, required — An optional description of the tax configuration.
    - `rate_sets` RateSet[], required — The percentage of tax to be applied for this revenue centre.
      - `id` string, uuid, required — An ID for the tax set.
      - `valid_from` string, date-time, nullable, required — The date and time after which this tax set should apply.
      - `valid_to` string, date-time, nullable, required — The date and time until which this tax set should apply.
      - `tax_rates` TaxRate[], required — The tax rates that should be applied when this tax rate is valid.
        - `name` string, required — A name for the tax rate.
        - `percentage` number, required — The percentage of tax that should be applied
        - `basis` 'net' | 'cumulative', required — The base amount on which the tax should be calculated. If cumulative then the tax will be calculated based on the net amount plus the amount of all previous tax rates in the current tax set.
        - `inclusive` boolean, required — Whether the price the customer sees includes this tax amount.

## Other responses

- `401` — The user is unauthenticated
- `404` — The resource couldn't be found

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)