Delete account

Permanently deletes an account. Only allowed when:

• All wallet balances are zero
• No pending transactions
• Account is not suspended/blocked

DELETE /accounts/{accountId}

Delete account

cURL

curl --request DELETE \
  --url https://api.venlyfinance.com/v1/accounts/{accountId} \
  --header 'Authorization: Bearer <token>'

400

{
  "success": false,
  "errors": [
    {
      "code": "VALIDATION_ERROR",
      "message": "The request contains invalid parameters."
    }
  ]
}

Authorizations

Authorization · string · header · required

OAuth2 client credentials flow. Token endpoints:

• Staging: https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token
• Production: https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token

Path Parameters

accountId · string<uuid> · required

Response

204

Account deleted