---
title: "List Tax Exemption Usages"
method: GET
path: "/accounts/{account_id}/tax_exemption_usages"
tags: ["Taxes"]
---

# List Tax Exemption Usages

`GET /accounts/{account_id}/tax_exemption_usages`

## Path parameters

- `account_id` string, required

## Query parameters

- `year` string — Use this parameter to filter for tax exemption usage of a specific year.
- `cursor` string
- `limit` integer

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponseTaxExemptionUsageResponse
  - `data` TaxExemptionUsageResponse[], required — The elements of the response.
    - `year` string, required — The year for the tax exemption usage.
    - `amount_total` string, required — The total amount of the corresponding tax exemption order.
    - `amount_used` string, required — The utilized amount of the corresponding tax exemption order. Use the difference between `amount_total - amount_used` to determine the amount still available.
    - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the `amount_total` and `amount_used` listed here. The only currently available currency is `"EUR"`.
  - `pagination` EncodedPaginationResponse, required — Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string — When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

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