curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
{
"message": "Registration deleted successfully."
}
{
"error": {
"type": "CANNOT_DELETE_VALID",
"title": "Cannot delete registration.",
"detail": "Registration with validation_status of VALID cannot be deleted; please contact the Commenda team.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Registrations V2
Delete Registration
Permanently delete a V2 registration
DELETE
/
api
/
v1
/
registrations
/
v2
/
{tax_registration_id}
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
{
"message": "Registration deleted successfully."
}
{
"error": {
"type": "CANNOT_DELETE_VALID",
"title": "Cannot delete registration.",
"detail": "Registration with validation_status of VALID cannot be deleted; please contact the Commenda team.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Permanently delete a V2 registration. This action cannot be undone.
Registrations with
validation_status: VALID cannot be deleted. Contact Commenda support if you need to remove a validated registration.Path parameters
string
required
The unique identifier (UUID) of the registration to delete.
When to use delete vs. close vs. archive
| Action | Use case | Effect |
|---|---|---|
| Delete | Remove a duplicate, test, or erroneous registration | Permanently removes the registration |
| Close | Stop selling in a jurisdiction on a specific date | Sets end date, preserves historical records |
| Archive | Completely disable a registration | Stops calculations, hidden from default list views |
Deletable registrations
A registration can only be deleted whenvalidation_status is not VALID. This means registrations with status PENDING or INVALID can be deleted.
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
{
"message": "Registration deleted successfully."
}
{
"error": {
"type": "CANNOT_DELETE_VALID",
"title": "Cannot delete registration.",
"detail": "Registration with validation_status of VALID cannot be deleted; please contact the Commenda team.",
"status": 400,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Related
- Close Registration — End on a specific date
- Archive Registration — Completely disable
- Tax Registrations V2 Overview — Registration lifecycle
Was this page helpful?