Skip to content

MngGetCustomerByLogin

Deprecated

The command still works, with no change to its request, response, or required permissions. It is superseded by a pair of commands split by customer kind: MngGetClientByLogin (see_clients) and MngGetLeadByLogin (see_leads). See Deprecated Commands.

Returns the customer linked to a trading account login.

If account has customer_id = 0, the method returns not found.

Access Control

Requires CRM access and see_customers. The linked customer brand and desk must be inside the manager scope. Admin scope bypasses this check.

If the manager does not have see_customer_contacts, customer email and phone are returned masked.

Request

{
  "command": "MngGetCustomerByLogin",
  "extID": "1",
  "data": {
    "login": 100001
  }
}

Response Data

{
  "customer": {
    "customer_id": 1,
    "avatar": "8e68414e-0e3f-48dd-b7b8-f5be9e26d4f7.svg",
    "email": "[email protected]",
    "full_name": "John Smith",
    "lifecycle_flags": 5,
    "customer_kind": 1,
    "conversion_flags": 1
  }
}

lifecycle_stage is no longer part of the customer object. Milestones are returned as the lifecycle_flags bit mask, and the lead or client kind as customer_kind; see Lifecycle Flags and Lead and Client Kind.