Skip to main content
Use this endpoint to permanently remove a registered bank account from SpherePay. Once deleted, the account ID can no longer be used in transfer requests. You cannot delete a bank account that has pending or active transfers associated with it.
This action is irreversible. Ensure you have no active or pending transfers referencing this bank account before deleting it.

​
Endpoint

DELETE https://api.spherepay.co/v2/bank-account/{id}

​
Authentication

All requests require a Bearer token in the Authorization header. 
Authorization: Bearer <token>

​
Path parameters

​
id
string
required
The bank account ID to delete (e.g., "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045").
  -H "Authorization: Bearer $SPHERE_API_KEY"

​
Response fields

​
ok
boolean
Returns true when the bank account was successfully deleted.
  "ok": true
}

​
Error responses

StatusCodeDescription
400address/invalidThe request is malformed or the ID format is invalid.
404resource/not-foundNo bank account with the specified ID exists.
422validation/failedValidation failed. The response includes a per-field errors array.
Last modified on May 12, 2026