Retrieving tax exemption orders
Via the Investment API, you have the option to retrieve tax exemption orders either for a specific user or a specific order specified by its ID.
Get tax exemptions of a user
To retrieve the tax exemptions of a user, call
GET /users/{user_id}/tax_exemptions
Example response
{
"id": "f1a57a04-1a89-4dab-ae3a-ff9b2a9377c1",
"created_at": "2024-01-01T10:33:43Z",
"updated_at": "2024-01-01T10:33:43Z",
"status": "ACTIVE",
"user_ids": [
"70821d79-366f-4873-804b-14857d690496"
],
"country": "DE",
"tax_exemption_type": "SINGLE",
"valid_from_year": "2024",
"valid_to_year": "2025",
"tax_exemption_details": [
{
"tax_year": "2025",
"tax_exemption_amount": {
"amount": "1100.00",
"currency": "EUR"
},
"utilized_amount": {
"amount": "0.00",
"currency": "EUR"
},
"remaining_amount": {
"amount": "1100.00",
"currency": "EUR"
},
"created_at": "2025-01-01T10:33:43Z",
"updated_at": "2025-01-01T10:33:43Z"
},
{
"tax_year": "2024",
"tax_exemption_amount": {
"amount": "1000.00",
"currency": "EUR"
},
"utilized_amount": {
"amount": "0.00",
"currency": "EUR"
},
"remaining_amount": {
"amount": "1000.00",
"currency": "EUR"
},
"created_at": "2024-01-01T10:33:43Z",
"updated_at": "2024-01-01T10:33:43Z"
}
]
}
Get a tax exemption by ID
To get the tax exemption specified by its ID, call
Example response
{
"id": "f1a57a04-1a89-4dab-ae3a-ff9b2a9377c1",
"created_at": "2024-01-01T10:33:43Z",
"updated_at": "2024-01-01T10:33:43Z",
"status": "ACTIVE",
"user_ids": [
"70821d79-366f-4873-804b-14857d690496"
],
"country": "DE",
"tax_exemption_type": "SINGLE",
"valid_from_year": "2024",
"valid_to_year": "2025",
"tax_exemption_details": [
{
"tax_year": "2025",
"tax_exemption_amount": {
"amount": "1100.00",
"currency": "EUR"
},
"utilized_amount": {
"amount": "0.00",
"currency": "EUR"
},
"remaining_amount": {
"amount": "1100.00",
"currency": "EUR"
},
"created_at": "2025-01-01T10:33:43Z",
"updated_at": "2025-01-01T10:33:43Z"
},
{
"tax_year": "2024",
"tax_exemption_amount": {
"amount": "1000.00",
"currency": "EUR"
},
"utilized_amount": {
"amount": "0.00",
"currency": "EUR"
},
"remaining_amount": {
"amount": "1000.00",
"currency": "EUR"
},
"created_at": "2024-01-01T10:33:43Z",
"updated_at": "2024-01-01T10:33:43Z"
}
]
}
Was this page helpful?