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

​
tax_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 jurisdiction on a specific dateSets end date, preserves historical records
ArchiveCompletely disable a registrationStops calculations, hidden from default list views

​
Deletable registrations

A registration can only be deleted when validation_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."
}