curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
No content - Registration successfully deleted
{
"error": {
"type": "SERVER_INTERNAL_ERROR",
"title": "Failed to delete registration.",
"detail": "registration with validation_status of VALID cannot be deleted through api; please contact Commenda team",
"status": 500,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "CLIENT_MISSING_PARAMS",
"title": "Missing required parameter.",
"status": 400,
"instance": "/api/v1/registrations/{registration_id}"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Registrations
Delete Registration
Permanently delete a registration
DELETE
/
api
/
v1
/
registrations
/
{registration_id}
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
No content - Registration successfully deleted
{
"error": {
"type": "SERVER_INTERNAL_ERROR",
"title": "Failed to delete registration.",
"detail": "registration with validation_status of VALID cannot be deleted through api; please contact Commenda team",
"status": 500,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "CLIENT_MISSING_PARAMS",
"title": "Missing required parameter.",
"status": 400,
"instance": "/api/v1/registrations/{registration_id}"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Permanently delete a registration. This action cannot be undone.
Registrations with
validation_status: VALID cannot be deleted via API. If you need to remove a validated registration, please contact Commenda support.Path Parameters
string
required
The unique identifier (UUID) of the registration to delete.
When to Use Delete vs. Close vs. Archive
Deletable Registrations
A registration can only be deleted whenvalidation_status is one of:
PENDING— Default status, validation not yet requestedVALIDATION_IN_PROGRESS— Validation underway but not completeINVALID— Validation failed
Non-Deletable Registrations
Registrations withvalidation_status: VALID cannot be deleted because:
- Filing history may be associated with the registration
- Tax calculations reference the registration
- Compliance records must be preserved
curl --request DELETE \
--url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7' \
--header 'Authorization: Bearer <your_token>'
No content - Registration successfully deleted
{
"error": {
"type": "SERVER_INTERNAL_ERROR",
"title": "Failed to delete registration.",
"detail": "registration with validation_status of VALID cannot be deleted through api; please contact Commenda team",
"status": 500,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
{
"error": {
"type": "CLIENT_MISSING_PARAMS",
"title": "Missing required parameter.",
"status": 400,
"instance": "/api/v1/registrations/{registration_id}"
}
}
{
"error": {
"type": "REGISTRATION_NOT_FOUND",
"title": "Registration not found.",
"status": 404,
"instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}
}
Related
- Close Registration — End on a specific date
- Archive Registration — Completely disable
- Tax Registrations Overview — Registration lifecycle
Was this page helpful?