---
title: "Get taxes"
method: GET
path: "/public/v1/taxes"
tags: ["Tax"]
---

# Get taxes

`GET /public/v1/taxes`

List the taxes configured for the authenticated company. A tax is a named, reusable tax rate
(percentage) that gets applied to [order](#model-order) and [invoice](#model-invoice) line
totals. Use this to enumerate the taxes you can reference elsewhere and to read their current
rates, codes, and QuickBooks Online mappings.

Results are ordered oldest-first (by creation time) and paginated. Soft-deleted taxes are never
returned. This endpoint is read-only — taxes cannot be created, edited, or deleted through the
public API — so it has no effect on inventory, compliance, or any other entity.

Required permission: `settings_permissions_taxes`.

## Query parameters

- `ids` string[]
- `inserted_datetime` string
- `updated_datetime` string
- `page` string

## Response `200`

A list of taxes

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission

---

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