> ## Documentation Index
> Fetch the complete documentation index at: https://docs.commenda.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Registration

> Permanently delete a V2 registration

Permanently delete a V2 registration. This action cannot be undone.

<Warning>
  Registrations with `validation_status: VALID` cannot be deleted. Contact [Commenda support](mailto:support@commenda.io) if you need to remove a validated registration.
</Warning>

## Path parameters

<ParamField path="tax_registration_id" type="string" required>
  The unique identifier (UUID) of the registration to delete.
</ParamField>

## 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**](/engine/indirect-tax/registrations/v2/registrations-v2-id-close-POST)     | Stop selling in a jurisdiction on a specific date   | Sets end date, preserves historical records        |
| [**Archive**](/engine/indirect-tax/registrations/v2/registrations-v2-id-archive-POST) | 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.

<RequestExample>
  ```bash cURL theme={null}
  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>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "message": "Registration deleted successfully."
  }
  ```

  ```json 400 - Cannot delete valid registration theme={null}
  {
    "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"
    }
  }
  ```

  ```json 404 - Not found theme={null}
  {
    "error": {
      "type": "REGISTRATION_NOT_FOUND",
      "title": "Registration not found.",
      "status": 404,
      "instance": "/api/v1/registrations/v2/7c9e6679-7425-40de-944b-e07fc1f90ae7"
    }
  }
  ```
</ResponseExample>

## Related

* [Close Registration](/engine/indirect-tax/registrations/v2/registrations-v2-id-close-POST) — End on a specific date
* [Archive Registration](/engine/indirect-tax/registrations/v2/registrations-v2-id-archive-POST) — Completely disable
* [Tax Registrations V2 Overview](/engine/indirect-tax/registrations/v2/registrations-v2) — Registration lifecycle