MngGetManagersByFilter

Description: Returns visible manager accounts filtered from the in-memory staff cache. Response rows use the same structure as GetManagers. Brand scope is applied before pagination and count calculation.

Super admins can query all visible managers. Other staff can query only non-super managers in their own brand. Hidden recovery manager id=1 never participates in filtering, totals, sorting, or pagination.

Access Control

🛡️ Access Level Required: SESSION_ADMIN or SESSION_MANAGER

---

Request Parameters

All request parameters are optional. If no filter is passed, the command returns all managers.

Field	Type	Description
access_backoffice	int	Shortcut filter. 1 returns managers with BackOffice access, 0 returns managers without it
access_crm	int	Shortcut filter. 1 returns managers with CRM access, 0 returns managers without it
limit	int	Optional page size
offset	int	Optional page offset
where	array	Optional filter conditions in the same format as GetUsersByFilter: [field, operator, value]
orWhere	array	Optional OR comparison group; at least one condition must match
whereNot	array	Optional negative filter conditions
whereIn	array	Optional inclusion filter conditions
whereNotIn	array	Optional exclusion filter conditions
whereBetween	array	Optional range filter conditions
whereNotBetween	array	Optional negative range filter conditions
orderBy	array	Optional sorting. Supports ["field", "ASC"] / ["field", "DESC"]

Supported filter fields include manager identity/profile fields, access scopes, runtime state, and permission flags returned by GetManagers. The admin and super_admin fields can be used in where and orderBy expressions.

Request Examples

CRM managers:

{
  "where": [
    ["access_crm", "=", 1]
  ],
  "orderBy": ["name", "ASC"]
}

Managers with both CRM and BackOffice access:

{
  "where": [
    ["access_crm", "=", 1],
    ["access_backoffice", "=", 1]
  ]
}

Shortcut form:

{
  "access_crm": 1,
  "access_backoffice": 0
}

---

Response Parameters

Field	Type	Description
rows	array	Manager rows with the same fields as GetManagers
count	int	Total number of rows matching the filter before pagination

Response Example

{
  "rows": [
    {
      "id": 2,
      "admin": 0,
      "super_admin": 0,
      "enable": 1,
      "access_backoffice": 0,
      "access_crm": 1,
      "groups": "*",
      "name": "CRM Manager",
      "email": "[email protected]",
      "brand": "default",
      "see_customers": 1,
      "set_customers": 1,
      "see_leads": 1,
      "set_leads": 1,
      "see_finance": 1,
      "online": 0
    }
  ],
  "count": 1
}

See also MngGetManagersCustomerStatsByFilter for the same manager selection returned as aggregated customer statistics.