bankAccount.delete
Remove a Bank Account entity from a Subject Record.
POST http://api.kompliant.com/bankAccount.delete (OpenAPI specification)
Usage Info
This method permanently deletes a Bank Account entity from the system. Use with caution as this operation cannot be undone. Typically used when account information is incorrect or when accounts are no longer active.
Note that a Bank Account entity cannot be deleted if it is currently associated with a Business. You must first remove the association using the business.removeBankAccount method before deletion can be completed.
Request
Authentication: KSig1-HMAC-SHA256
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| bank_account_id | string | Yes | The ID of the Bank Account. |
Example
{
"bank_account_id": "ba_6zNzQZHSf26V83BO3uW6dS"
}
Response
Data
An empty data object is returned when the delete is successful.
Example
{
"meta": {
"status": "SUCCESS",
"trace_id": "trc_34nbsAG42mPtERBYvIvyPB",
"version": "2025-03-24"
},
"data": {}
}
Errors
| Error Code | HTTP Code | Possible Cause |
|---|---|---|
| BAD_REQUEST | 400 | Required parameters not provided. |
| ENTITY_LINKED | 400 | The Bank Account cannot be deleted because it is currently linked to a Business entity. You must first remove the association using the business.removeBankAccount method before the Bank Account can be deleted. |
| ENTITY_NOT_FOUND | 400 | The business_id provided does not exist. |
Updated 7 months ago