---
title: "Retrieve all taxes"
method: GET
path: "/consumers/{consumer_id}/invoicing/taxes"
tags: ["Invoicing", "Taxes"]
---

# Retrieve all taxes

`GET /consumers/{consumer_id}/invoicing/taxes`

Returns a list of all the taxes

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Successful Response

- ChiftPageInvoicingVatCode
  - `items` InvoicingVatCode[], required
    - `id` string, required — Technical id in Chift
    - `source_ref` Ref, required
      - `id` string, nullable — Technical id in the target software
      - `model` string, nullable — Name of the model/entity in the target software
    - `label` string, required — Label
    - `rate` number, required — Tax rate (e.g. 21.0)
    - `type` 'sale' | 'purchase' | 'both' | 'unknown', required
    - `code` string, nullable — Code
    - `scope` 'nat' | 'eu' | 'int' | 'unknown'
    - `active` boolean, nullable — Is the tax active?
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/revisions/b5f1214a482a/schema)
