Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt

Use this file to discover all available pages before exploring further.

Use this endpoint to permanently remove a registered wallet from SpherePay. Once deleted, the wallet ID can no longer be used in transfer requests. You cannot delete a wallet that is referenced as the source or destination of any active or pending transfer.
This action is irreversible. Ensure no active or pending transfers reference this wallet before deleting it.

​
Endpoint

DELETE https://api.spherepay.co/v2/wallet/{id}

​
Authentication

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

​
Path parameters

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

​
Response fields

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

​
Error responses

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