Companies list

The method allows you to get a list of companies

Limitations

The method is available in correspondence to the user rights.

“with” Parameters

ParameterDescription
leadsAdds info on the leads linked to the company into the response
contactsAdds info on the contacts linked to the company into the response
catalog_elementsAdds lists elements linked to the company 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

The properties of a company object are listed below.

Parameter

Data type

Description

id

int

Company ID

name

string

Company name

responsible_user_id

int

Company responsible user ID

group_id

int

Group ID of the company responsible user

created_by

int

The ID of the user who created the company

updated_by

int

The ID of the user who updated the company last

created_at

int

Company creation date in the format of Unix Timestamp

updated_at

int

Company 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 company custom fields’ values

account_id

int

Account ID where the company is located in

  • embedded

object

Embedded entities data

  • embedded[tags]

array

Company tags data array

  • embedded[tags][0]

object

Company 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[contacts]

array

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

  • embedded[contacts][0]

object

Linked contact data

  • embedded[contacts][0][id]

int

Linked contact 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!