Skip to main content
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"}'

{
  "message": "Successfully closed registration."
}
Close a registration when you stop doing business in a jurisdiction. This sets an effective_end_date and stops tax calculations and filings for transactions after that date.

​
Path Parameters

​
registration_id
string
required
The unique identifier (UUID) of the registration to close.

​
Request Body

​
effective_end_date
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 the effective_end_date:
  1. Tax calculations — The /calculate endpoint returns zero tax for this jurisdiction
  2. Filing — No returns are filed for periods after the end date
  3. 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 TypeEffect
State registrationCloses the state and all local registrations under it with the same effective_end_date
Local registrationCloses 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

ActionUse CaseEffect on CalculationsPreserves History
CloseStop selling on a dateTax calculated only within date rangeYes
ArchiveCompletely disableStopped entirelyYes
DeleteRemove entirelyRemoved immediatelyNo
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"}'

{
  "message": "Successfully closed registration."
}

​
After Closing

The registration will show the effective_end_date field: 
{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "effective_start_date": "2024-01-01",
  "effective_end_date": "2024-12-31",
  "validation_status": "VALID",
  "...": "..."
}
If you need to reopen a closed registration, contact Commenda support.