get
https://{subdomain}.kommo.com/api/v4/contacts/
This method allows to get a particular contact data by its ID
Limitations
Method is available in correspondence to the user rights.
“with” Parameters
| Parameter | Description |
|---|---|
| leads | Adds info on the leads linked to the contact into the response |
| catalog_elements | Adds lists elements linked to the contact into the response |
Data type header when the request is successful
Content-Type: application/hal+json
Data type header in case of an error
Content-Type: application/problem+json
Response parameters
| Parameter | Data type | Description |
|---|---|---|
| id | int | Contact ID |
| name | string | Contact fullname |
| first_name | string | Contact first name |
| last_name | string | Contact last name |
| responsible_user_id | int | Contact responsible user ID |
| group_id | int | Group ID of the contact responsible user |
| created_by | int | ID of the user who created the contact |
| updated_by | int | ID of the user who updated the contact last |
| created_at | int | Contact creation date in the format of Unix Timestamp |
| updated_at | int | Contact update date in the format of Unix Timestamp |
| closest_task_at | int | Date of the closest open task in the format of Unix Timestamp |
| custom_fields_values | array|null | An array of the current contact custom fields’ values |
| account_id | int | Account ID where the contact is located in |
| object | Embedded entities data |
| array | Contact tags data array |
| object | Contact tag model |
| int | Tag ID |
| string | Tag name |
| string/null | Tag color |
| array | Linked company data array. This array always consists of 1 element. |
| object | Linked company data |
| int | Linked company ID |
| array | GET parameter “with” is required. Linked leads data array |
| object | Linked lead data |
| int | Linked lead ID |
| array | GET parameter “with” is required. Linked lists’ elements data array |
| object | Linked list element data |
| int | Linked element ID |
| object | Meta-data of the element |
| int | Linked elements quantity |
| int | ID of the linked element’s list |