🚀 VaultsPay API v1 is live. See what's new →
UsersDelete User

Delete User

Soft-deletes a user. The record is retained for regulatory compliance but hidden from subsequent list calls by default.

DELETE/v1/users/{id}
⚠️

Deleting a user also freezes all their cards and closes their accounts. This cannot be undone via the API — contact support if a user was deleted in error.

Request

curl -X DELETE https://api.vaultspay.ae/v1/users/usr_01HX71YM6FJ3A8W7T5K6NRB2DN \
  -H "Authorization: Bearer sk_test_yourApiKeyHere"

Response

200 OK
{
  "id": "usr_01HX71YM6FJ3A8W7T5K6NRB2DN",
  "object": "user",
  "status": "deleted",
  "deleted_at": "2026-04-24T14:52:03.182Z"
}

Errors

HTTPCodeDescription
404not_foundNo user with that ID.
409user_has_open_balanceUser has non-zero balances. Settle them first.