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

ParameterTypeRequiredDescription
bank_account_idstringYesThe 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 CodeHTTP CodePossible Cause
BAD_REQUEST400Required parameters not provided.
ENTITY_LINKED400The 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_FOUND400The business_id provided does not exist.