MngGetClientContacts¶
Returns the full, unmasked contact fields of one client. 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_MANAGERSESSION_ADMINSESSION_DEALERSESSION_CRM_MANAGERSESSION_CRM_ADMIN
The caller must have CRM access and see_clients_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": "MngGetClientContacts",
"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 client |
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.