---
title: "List all taxes"
method: GET
path: "/taxes"
tags: ["taxes"]
---

# List all taxes

`GET /taxes`

This endpoint retrieves all existing taxes representing a customizable tax rate applicable to either the organization or a specific customer.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Taxes

- TaxesPaginated
  - `taxes` TaxObject[], required
    - `lago_id` string, uuid, required — Unique identifier of the tax, created by Lago.
    - `name` string, required — Name of the tax.
    - `code` string, required — Unique code used to identify the tax associated with the API request.
    - `description` string, nullable — Internal description of the tax
    - `rate` number, required — The percentage rate of the tax
    - `applied_to_organization` boolean, required — **Deprecated.** This field will be removed in a future version. When set to true, it applies the tax to the organization's default billing entity. To apply or remove a tax from any billing entity (including the default one), please use the `PUT /billing_entities/:code` endpoint instead.
    - `created_at` string, date-time, required — Creation date of the tax.
  - `meta` PaginationMeta, required
    - `current_page` integer, required — Current page.
    - `next_page` integer, nullable — Next page.
    - `prev_page` integer, nullable — Previous page.
    - `total_pages` integer, required — Total number of pages.
    - `total_count` integer, required — Total number of records.

## Other responses

- `401` — Unauthorized error

---

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