Delete Registration

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

DELETE

api

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

Action	Use Case	Effect
Delete	Remove a duplicate, test, or erroneous registration	Permanently removes the registration
Close	Stop selling in a jurisdiction	Sets end date, keeps for historical records
Archive	Completely disable	Stops 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:

Filing history may be associated with the registration
Tax calculations reference the registration
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

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

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

Get Started

Registrations

Registrations V2

Corporations

Tax Calculations

Transactions

Address Requirements

Registration Thresholds

Products

Customers

Exemption Certificates

Exemptions

Files

Credentials

Locations

Filings

Webhooks

Path Parameters

When to Use Delete vs. Close vs. Archive

Deletable Registrations

Non-Deletable Registrations

​Path Parameters

​When to Use Delete vs. Close vs. Archive

​Deletable Registrations

​Non-Deletable Registrations

​Related

Path Parameters

When to Use Delete vs. Close vs. Archive

Deletable Registrations

Non-Deletable Registrations

Related