Creating a tax exemption order
Prerequisites
In order to create a new tax exemption, Upvest must have the user’s Tax Identification Number (TIN).
To submit a tax exemption request, execute the following request:
POST /tax_exemptions/
Example request
{
"user_ids": [
"70fd317b-81e1-4f21-9f7e-3b5cb4dfe686"
],
"tax_exemption_details": {
"tax_exemption_type": "SINGLE",
"tax_exemption_amount": {
"currency": "EUR",
"amount": "1000"
}
},
"country": "DE",
"valid_to_date": "2024-12-31"
}
The request body contains the following:
Example response
{
"id": "f1a57a04-1a89-4dab-ae3a-ff9b2a9377c1"
}
The ID in the response is the ID of the tax exemption created.
Note that the tax exemption is only active when a response indicating its activation is received via a webhook. At this current stage of the process, it still has the status NEW
.
Request rejected
The API can discard a request before it is accepted for downstream processing.
This happens if it does not pass the validation of the input data and additional internal consistency checks. Reasons for such behaviour can be, for example, missing parameters or if the requested tax exemption amount exceeds the maximum amount.
Read also the webhooks section of this guide.
Was this page helpful?