Close Registration

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"effective_end_date": "2024-12-31"}'

{
  "effective_end_date": "2024-12-31"
}

{
  "message": "Successfully closed registration."
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date.",
    "detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

POST

api

registrations

{registration_id}

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"effective_end_date": "2024-12-31"}'

{
  "effective_end_date": "2024-12-31"
}

{
  "message": "Successfully closed registration."
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date.",
    "detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

Close a registration when you stop doing business in a jurisdiction. This sets an effective_end_date and stops tax calculations and filings for transactions after that date.

Path Parameters

string

required

The unique identifier (UUID) of the registration to close.

Request Body

string

required

ISO date (YYYY-MM-DD) when the registration ends. Must not be before the effective_start_date.Example: "2024-12-31"

When to Close a Registration

Close a registration when:

Leaving a state — You’re no longer selling to customers in that jurisdiction
Closing a tax account — You’ve closed your account with the state
Business closure — The corporation is ceasing operations in that jurisdiction

Effect of Closing

After the effective_end_date:

Tax calculations — The /calculate endpoint returns zero tax for this jurisdiction
Filing — No returns are filed for periods after the end date
Historical data — All transaction and filing history is preserved

Closing a registration does not affect filings for periods up to and including the end date. Commenda will still file final returns as needed.

Cascade Behavior

Registration Type	Effect
State registration	Closes the state and all local registrations under it with the same `effective_end_date`
Local registration	Closes only the local registration (no cascade)

Closing a state registration will automatically close all local registrations under that state with the same end date. This is a bulk operation.

Close vs. Archive vs. Delete

Action	Use Case	Effect on Calculations	Preserves History
Close	Stop selling on a date	Tax calculated only within date range	Yes
Archive	Completely disable	Stopped entirely	Yes
Delete	Remove entirely	Removed immediately	No

curl --request POST \
  --url 'https://transaction-tax.api.in.commenda.io/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{"effective_end_date": "2024-12-31"}'

{
  "effective_end_date": "2024-12-31"
}

{
  "message": "Successfully closed registration."
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date.",
    "detail": "Effective end date (2024-01-01) cannot be before the effective start date (2024-06-01).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "CLIENT_INVALID_REQUEST_BODY",
    "title": "Invalid effective_end_date format.",
    "detail": "Date must be in ISO format (YYYY-MM-DD).",
    "status": 400,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

{
  "error": {
    "type": "REGISTRATION_NOT_FOUND",
    "title": "Registration not found.",
    "status": 404,
    "instance": "/api/v1/registrations/7c9e6679-7425-40de-944b-e07fc1f90ae7/close"
  }
}

After Closing

The registration will show the effective_end_date field:

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "effective_start_date": "2024-01-01",
  "effective_end_date": "2024-12-31",
  "validation_status": "VALID",
  "...": "..."
}

If you need to reopen a closed registration, contact Commenda support.

Archive Registration — Completely disable (stops all calculations)
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

Request Body

When to Close a Registration

Effect of Closing

Cascade Behavior

Close vs. Archive vs. Delete

After Closing

​Path Parameters

​Request Body

​When to Close a Registration

​Effect of Closing

​Cascade Behavior

​Close vs. Archive vs. Delete

​After Closing

​Related

Path Parameters

Request Body

When to Close a Registration

Effect of Closing

Cascade Behavior

Close vs. Archive vs. Delete

After Closing

Related