Skip to content

MngGetLeadContacts

Returns the full, unmasked contact fields of one lead. This is the dedicated command for open contacts: the ordinary read commands mask them unless the manager holds the contact permission.

The command is available through the manager command API only; there is no REST path for it. The kind is fixed by the command name, so customer_kind is not accepted on input. See Clients and Leads Commands.

It replaces the deprecated MngGetCustomerContacts.

Access Control

Allowed sessions:

  • SESSION_MANAGER
  • SESSION_ADMIN
  • SESSION_DEALER
  • SESSION_CRM_MANAGER
  • SESSION_CRM_ADMIN

The caller must have CRM access and see_leads_contacts. The record brand and desk must be inside the manager scope; admin scope bypasses this check.

Every call is written to the journal, successful ones included: the response discloses personal data, so the record marks a disclosure rather than a query.

Request

{
  "command": "MngGetLeadContacts",
  "extID": "1",
  "data": {
    "customer_id": 1
  }
}

Request Data

Field Type Required Description
customer_id int Yes Target customer id, 1 or greater

Response Data

{
  "customer_id": 1,
  "email": "[email protected]",
  "phone": "+35700000000"
}

Errors

HTTP Error Description
400 INVALID_DATA Request validation failed
400 RET_INVALID_DATA The customer exists but is not a lead
403 RET_NOT_ENOUGH_RIGHTS Missing permission, missing scope, or the record is outside the caller's visibility
404 RET_NOT_FOUND No customer with that identifier exists

Every error carries a message field with free-form text. Its contents are not part of the contract; branch on error.