Contacts List

This method allows to get a list of contacts in the account

Limitations
Method is available in correspondence to the user rights.

“with” Parameters

ParameterDescription
leadsAdds info on the leads linked to the contact into the response
catalog_elementsAdds 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

  • embedded

object

Embedded entities data

  • embedded[tags]

array

Contact tags data array

  • embedded[tags][0]

object

Contact tag model

  • embedded[tags][0][id]

int

Tag ID

  • embedded[tags][0][name]

string

Tag name

  • embedded[tags][0][color]

string/null

Tag color

  • embedded[companies]

array

Contact tag model

  • embedded[companies][0]

object

Linked company data

  • embedded[companies][0][id]

int

Linked company ID

  • embedded[leads]

array

GET parameter “with” is required.
Linked leads data array

  • embedded[leads][0]

object

Linked lead data

  • embedded[leads][0][id]

int

Linked lead ID

  • embedded[catalog_elements][catalog_elements]

array

GET parameter “with” is required.
Linked lists’ elements data array

  • embedded[catalog_elements][0]

object

Linked list element data

  • embedded[catalog_elements][0][id]

int

Linked element ID

  • embedded[catalog_elements][0][metadata]

object

Meta-data of the element

  • embedded[catalog_elements][0][quantity]

int

Linked elements quantity

  • embedded[catalog_elements][0][catalog_id][catalog_id]

int

ID of the linked element’s list

Language
Credentials
OAuth2
URL
Click Try It! to start a request and see the response here!