curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/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": "Successfully closed registration."
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date.",
"detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date format.",
"detail": "Date must be in ISO format (YYYY-MM-DD).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
Registrations
Close Registration
Close a registration by setting an effective end date
POST
/
api
/
v1
/
registrations
/
{registration_id}
/
close
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/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": "Successfully closed registration."
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date.",
"detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date format.",
"detail": "Date must be in ISO format (YYYY-MM-DD).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
Close a registration when you stop doing business in a jurisdiction. This sets an
If you need to reopen a closed registration, contact Commenda support.
effective_end_date and stops tax calculations and filings 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"When to Close a Registration
Close a registration when:- Leaving a state — You’re no longer selling to customers in that jurisdiction
- Closing a tax account — You’ve closed your account with the state
- Business closure — The corporation is ceasing operations in that jurisdiction
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. Commenda will still file final returns as needed.
Cascade Behavior
| Registration Type | Effect |
|---|---|
| State registration | Closes the state and all local registrations under it with the same effective_end_date |
| Local registration | Closes only the local registration (no cascade) |
Closing a state registration will automatically close all local registrations under that state with the same end date. This is a bulk operation.
Close vs. Archive vs. Delete
curl --request POST \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/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": "Successfully closed registration."
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date.",
"detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "CLIENT_INVALID_REQUEST_BODY",
"title": "Invalid effective_end_date format.",
"detail": "Date must be in ISO format (YYYY-MM-DD).",
"status": 400,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
}
}
After Closing
The registration will show theeffective_end_date field:
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"effective_start_date": "2024-01-01",
"effective_end_date": "2024-12-31",
"validation_status": "VALID",
"...": "..."
}
Related
- Archive Registration — Completely disable (stops all calculations)
- Tax Registrations Overview — Registration lifecycle
Was this page helpful?