DELETE /v1/bank-accounts/{bankAccountId} — Remove a Bank Account

Remove a bank account from your business. Once deleted, the account’s status transitions to removed and it can no longer be used to initiate payments. This action is irreversible — you will need to link a new account if you want to restore access.

HTTP Request

DELETE https://api.cleo-pay.com/v1/bank-accounts/{bankAccountId}

Authentication

Include your bearer token on every request:

Authorization: Bearer <token>

Path Parameters

bankAccountId

string

required

The unique identifier of the bank account to remove. This is the id returned when the account was created, or from the list accounts response.

Response

This endpoint returns 204 No Content on success. No response body is returned.

Example Request

curl --request DELETE \
  --url https://api.cleo-pay.com/v1/bank-accounts/ba_01j9kxm2p4fghe3t7q8wnvd5rc \
  --header 'Authorization: Bearer <token>'

Example Response

HTTP/1.1 204 No Content

Deleting a bank account is permanent. The account status is set to removed and the account cannot be restored. If the deleted account was your only verified account, you will need to link and verify a new one before you can process payments.

After deletion, the bank account record remains accessible via GET /v1/bank-accounts/ and GET /v1/bank-accounts with a status of removed. This allows you to maintain an audit trail of all accounts that have ever been linked to your business.

GET /v1/bank-accounts/{bankAccountId} — Get a Bank Account

POST /v1/bank-accounts/{bankAccountId}/verify-micro-deposits

⌘I

Payables

Bank Accounts

Contacts

Payments

DELETE /v1/bank-accounts/{bankAccountId} — Remove a Bank Account

HTTP Request

Authentication

Path Parameters

Response

Example Request

Example Response

​HTTP Request

​Authentication

​Path Parameters

​Response

​Example Request

​Example Response

HTTP Request

Authentication

Path Parameters

Response

Example Request

Example Response