---
title: "Create Tax Exemption Order"
method: POST
path: "/accounts/{account_id}/tax_exemption_orders"
tags: ["Taxes"]
---

# Create Tax Exemption Order

`POST /accounts/{account_id}/tax_exemption_orders`

## Path parameters

- `account_id` string, required

## Headers

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

## Request body

- CreateTaxExemptionOrderRequest — An object specifying a tax exemption order.
  - `amount_total` string, number, required — The amount to be exempt from capital gains.
  - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the `amount` listed here. The only currently available currency is "EUR".
  - `type` 'individual', required — A category describing the type of a tax exemption order: <ul> <li><code>individual</code>: Tax exemption limits for individuals apply to this order. </ul>
  - `valid_from` string, required — A string specifying the first year for this tax exemption order to be effective.
  - `valid_until` string — A string specifying the last year to consider this tax exemtption. **NOTE:** Must either be the same value as `valid_from` (to restrict the tax exemption to one year) or `null` (valid until the next tax exemption will be submitted).

## Response `201`

Successful Response

- TaxExemptionOrderResponse
  - `id` string, required — A string representing the unique identifier of this tax exemption order.
  - `amount_total` string, required — The amount to be exempt from taxation using the value from `currency`.
  - `type` 'individual', required — A category describing the type of a tax exemption order: <ul> <li><code>individual</code>: Tax exemption limits for individuals apply to this order. </ul>
  - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the `amount` listed here. The only currently available currency is "EUR".
  - `valid_from` string, required — A string specifying the first year for this tax exemption order to be effective.
  - `valid_until` string — A string specifying the last year to consider this tax exemtption. This is either be the same value as `valid_from` (to restrict the tax exemption to one year) or `null` (valid until the next tax exemption will be submitted).
  - `history` StatusChangeTaxExemptionOrderStatus[], required
    - `status` 'accepted' | 'canceled' | 'canceling' | 'created' | 'rejected', required — A category describing the status of a tax exemption order: <ul> <li><code>accepted</code> <li><code>canceled</code> <li><code>canceling</code> <li><code>created</code> <li><code>rejected</code> </ul>
    - `timestamp` string, date-time, required — The timestamp of the event. It represents the point in time at which the tax exemption was updated.

## 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)