Skip to content

MngDeleteAccountsList

Command: MngDeleteAccountsList

Deprecated alias: DeleteUsersList

DeleteUsersList is kept only for backward compatibility. New integrations must use MngDeleteAccountsList; the alias may be removed in a future release.

Description: Deletes multiple user accounts by their login IDs.

Delete policy for each account:

  • Active market positions and active pending orders block account deletion.
  • All four pending types are protected: BUY LIMIT, SELL LIMIT, BUY STOP and SELL STOP, including creation, modification and cancellation in progress.
  • Cancel pending orders and wait for cancellation to finish before deleting the account.
  • Once no blocking trades remain, account deletion also removes its trade history.

This method is batch-based:

  • successful rows are returned in rows
  • failed rows are returned in failures
  • the method no longer stops on the first failed login

Access Control

Requires del_accounts for manager/dealer sessions. Every target account must match the manager groups and brand scope loaded from the cached manager record. Token payload is used only for manager id and session type.

Request Parameters

Name Type Required Description
logins array Yes Array of integer login IDs to delete

Request Example

{
  "command": "MngDeleteAccountsList",
  "data": {
  "logins": [102030, 102031, 102032]
  }
}

Response Parameters

Name Type Description
rows array Successfully deleted accounts
matched int Number of requested logins
deleted int Number of successfully deleted accounts
failed int Number of failed deletions
failures array Per-login failure details when partial or full failure happens

Response Example

{
  "rows": [
    {
      "login": 102030,
      "deleted": true
    }
  ],
  "matched": 3,
  "deleted": 1,
  "failed": 2,
  "failures": [
    {
      "login": 102031,
      "error": "RET_USR_HAS_TRADES",
      "message": "Account has open trades"
    },
    {
      "login": 102032,
      "error": "RET_USER_NOT_FOUND",
      "message": "User not found"
    }
  ]
}

HTTP semantics:

  • 200 if all requested accounts were deleted
  • 207 if deleted partially
  • 409 if no account was deleted