Delete

Delete

This endpoint permanently removes one or more businesses from TaxBandits. This action cannot be undone. Once deleted, the business and its associated data are no longer accessible.

Key Points

• Multiple Deletion — Pass multiple BusinessId or PayerRef in a single request to delete businesses in bulk.
• IsForceDelete — By default, deletion is blocked if the business has associated returns. Setting IsForceDelete to true removes this restriction. Use with caution.
• Deactivate Instead — If you want to stop using a business without permanently deleting it, consider using the Deactivate endpoint instead.

DELETE business/delete 

Run in Postman

Request Body

Field	Type	Description
BusinessId	Guid	TaxBandits-generated unique identifier for the business.
PayerRef	string	Your unique identifier for the business.
IsForceDelete	Boolean	Optional When TRUE, deletes the business even if tax forms are associated with it.

Response Body

Field	Type	Description
SuccessRecords	Object []	Records that were processed successfully.
BusinessId	GUID	TaxBandits-generated unique identifier of the business.
PayerRef	String	Your unique identifier for the payer.
Status	String	Status of the operation.
StatusTs	String	Date and time the operation was completed.
ErrorRecords	Object []	Records that failed to process.
BusinessId	GUID	Identifier of the failed business.
PayerRef	String	Your unique identifier for the payer.
Errors	Object []	Validation error details.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Description of the error.

Request Json

Sample	Description	Action
Sample 1	Delete a business using BusinessId, PayerRef, and force delete flag.

Sample 1

business/delete?businessids=227fae48-afc8-47ec-af6d-d6893e0f7191&PayerRefs=Pe73648&IsForceDelete=true

Response Json

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.

{
  "SuccessRecords": [
      {
          "BusinessId": "6d968d22-d740-4282-976f-5dff17d61081",
          "PayerRef": "Pe77162",
          "Status": "DELETED",
          "StatusTs": "2026-07-07 09:58:47 -04:00"
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}