---
title: "Retrieve all tax rates."
method: GET
path: "/api/v2/organizations/{orgSlug}/tax-rates"
tags: ["Tax Rates"]
---

# Retrieve all tax rates.

`GET /api/v2/organizations/{orgSlug}/tax-rates`

## Request

- Base URL: `https://app.officernd.com`
- URL: `https://app.officernd.com/api/v2/organizations/{orgSlug}/tax-rates`
- Auth: OAuth 2
  - Authorization code: `https://identity.officernd.com/auth/authorize`
  - Client credentials
  - Token URL: `https://identity.officernd.com/auth/token` scopes: `flex.billing.taxRates.read`

Retrieve all tax rates. 

 Required scopes: `flex.billing.taxRates.read`

## Path parameters

- `orgSlug` string, required

## Query parameters

- `$select` string
- `$cursorNext` string
- `$cursorPrev` string
- `$limit` number

## Response `200`

- object
  - `rangeStart` number
  - `rangeEnd` number
  - `cursorNext` string
  - `cursorPrev` string
  - `results` TaxRateResultDto[]
    - `_id` string: The _id of the tax rate.
    - `name` string: The name of the tax rate in hand.
    - `code` string: A unique code to identify the tax rate.
    - `type` string: The type of the tax rate.
    - `rate` number: The rate of the tax rate. It will be automatically calculated based on the percentage rate of the components.
    - `components` TaxRateComponentDto[]: A list of tax rate components. Each tax rate component needs to have a name and rate of its own.
      - `_id` string: The _id of the tax rate component.
      - `name` string: The name of the tax rate component.
      - `rate` number: The rate of the tax rate component.

---

[API](https://skmtc.dev/officernd/apis/billing-product-api.md) - [All operations](https://skmtc.dev/officernd/apis/billing-product-api/llms.txt) - [OpenAPI document](https://skmtc.dev/officernd/apis/billing-product-api/revisions/78f9c9851fb0?raw)