Delete Registration - Commenda — Entity Management, Indirect Tax, Compliance & Corporate APIs for Multinationals

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"
  }
}

DELETE

api

registrations

{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

tax_registration_id

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 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."
}

{
  "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"
  }
}

Close Registration — End on a specific date
Archive Registration — Completely disable
Tax Registrations V2 Overview — Registration lifecycle

Update Registration Archive Registration

​Path parameters

​When to use delete vs. close vs. archive

​Deletable registrations

​Related

Path parameters

When to use delete vs. close vs. archive

Deletable registrations

Related