curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{"effective_end_date": "2024-12-31"}'
{
"effective_end_date": "2024-12-31"
}
{
"message": "Registration closed successfully."
}
{
"error": {
"type": "INVALID_EFFECTIVE_END_DATE",
"title": "Invalid effective_end_date.",
"detail": "Effective end date cannot be before the effective start date.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
Registrations V2
Close Registration
Close a V2 registration by setting an effective end date
POST
/
api
/
v1
/
registrations
/
v2
/
{tax_registration_id}
/
close
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{"effective_end_date": "2024-12-31"}'
{
"effective_end_date": "2024-12-31"
}
{
"message": "Registration closed successfully."
}
{
"error": {
"type": "INVALID_EFFECTIVE_END_DATE",
"title": "Invalid effective_end_date.",
"detail": "Effective end date cannot be before the effective start date.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
Close a registration when you stop doing business in a jurisdiction. This sets an
effective_end_date and stops tax calculations for transactions after that date.
Path parameters
string
required
The unique identifier (UUID) of the registration to close.
Request body
string
required
ISO date (YYYY-MM-DD) when the registration ends. Must not be before the
effective_start_date.Example: "2024-12-31"Effect of closing
After theeffective_end_date:
- Tax calculations — The
/calculateendpoint returns zero tax for this jurisdiction - Filing — No returns are filed for periods after the end date
- Historical data — All transaction and filing history is preserved
Closing a registration does not affect filings for periods up to and including the end date.
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
--header 'Authorization: Bearer <your_token>' \
--header 'Content-Type: application/json' \
--data '{"effective_end_date": "2024-12-31"}'
{
"effective_end_date": "2024-12-31"
}
{
"message": "Registration closed successfully."
}
{
"error": {
"type": "INVALID_EFFECTIVE_END_DATE",
"title": "Invalid effective_end_date.",
"detail": "Effective end date cannot be before the effective start date.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
Related
- Archive Registration — Completely disable (stops all calculations)
- Tax Registrations V2 Overview — Registration lifecycle
Was this page helpful?