Companies list

get

https://{subdomain}.kommo.com/api/v4/companies

The method allows you to get a list of companies

Limitations

The method is available in correspondence to the user rights.

“with” Parameters

Parameter	Description
leads	Adds info on the leads linked to the company into the response
contacts	Adds info on the contacts linked to the company into the response
catalog_elements	Adds 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

Query Params

with

string

This parameter takes a string that may consist of several values separated by commas. See the table above.

page

int32

Page of response

limit

int32

The number of the entities returned in the response to one request (limit – 250)

query

string

Search query (will perform a search by custom fields values)

order[updated_at]

string

enum

List elements sorting by the time companies were updated at

Allowed:

order[id]

string

enum

List elements sorting by companies IDs

Allowed:

filter[id][]

array of int32s

Filter by company ID

filter[id][]

filter[name][]

array of strings

Filter by company name

filter[name][]

filter[created_by][]

array of int32s

Filter by ID of the user who added the company.

filter[created_by][]

filter[updated_by][]

array of int32s

Filter by ID of the user who updated the company last

filter[updated_by][]

filter[responsible_user_id][]

array of int32s

Filter by ID of the company responsible user

filter[responsible_user_id][]

filter[created_at][from]

int32

Filter by the creation date of the company in Unix Timestamp format. As a response you will get all the companies added after the date.

filter[created_at][to]

int32

Filter by the creation date of the company in Unix Timestamp format. As a response you will get all the companies added before the date.

filter[updated_at][from]

int32

Filter by date in Unix Timestamp format when the company was updated. As a response you will get all the companies updated after the date.

filter[updated_at][to]

int32

Filter by date in Unix Timestamp format when the company was updated. As a response you will get all the companies updated before the date.

filter[closest_task_at][from]

int32

Filter leads by the date of the task closest to completion in Unix Timestamp format.

filter[closest_task_at][to]

int32

Filter leads by the date of the task closest to completion in Unix Timestamp format.

Responses

Response parameters

200200

401401