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

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

​
When to Use Delete vs. Close vs. Archive

ActionUse CaseEffect
DeleteRemove a duplicate, test, or erroneous registrationPermanently removes the registration
CloseStop selling in a jurisdictionSets end date, keeps for historical records
ArchiveCompletely disableStops all calculations, hidden from list

​
Deletable Registrations

A registration can only be deleted when validation_status is one of:
  • PENDING — Default status, validation not yet requested
  • VALIDATION_IN_PROGRESS — Validation underway but not complete
  • INVALID — Validation failed

​
Non-Deletable Registrations

Registrations with validation_status: VALID cannot be deleted because:
  1. Filing history may be associated with the registration
  2. Tax calculations reference the registration
  3. Compliance records must be preserved
For these cases, use the Close endpoint instead. 
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