--- updatedAt: 2025-06-08T14:09:58.000Z --- Fetch the complete documentation index at: https://developers.kommo.com/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version. # 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** | 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
# OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "kommo-api-references", "version": "1.0" }, "servers": [ { "url": "https://{subdomain}.kommo.com", "variables": { "subdomain": { "default": "subdomain" } } } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v4/companies": { "get": { "summary": "Companies list", "description": "The method allows you to get a list of companies", "operationId": "companies-list", "parameters": [ { "name": "with", "in": "query", "description": "This parameter takes a string that may consist of several values separated by commas. See the table above.", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Page of response", "schema": { "type": "integer", "format": "int32" } }, { "name": "limit", "in": "query", "description": "The number of the entities returned in the response to one request (limit – 250)", "schema": { "type": "integer", "format": "int32" } }, { "name": "query", "in": "query", "description": "Search query (will perform a search by custom fields values)", "schema": { "type": "string" } }, { "name": "order[updated_at]", "in": "query", "description": "List elements sorting by the time companies were updated at", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "order[id]", "in": "query", "description": "List elements sorting by companies IDs", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "filter[id][]", "in": "query", "description": "Filter by company ID", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[name][]", "in": "query", "description": "Filter by company name", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "filter[created_by][]", "in": "query", "description": "Filter by ID of the user who added the company.", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[updated_by][]", "in": "query", "description": "Filter by ID of the user who updated the company last", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[responsible_user_id][]", "in": "query", "description": "Filter by ID of the company responsible user", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[created_at][from]", "in": "query", "description": "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.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[created_at][to]", "in": "query", "description": "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.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][from]", "in": "query", "description": "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.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][to]", "in": "query", "description": "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.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[closest_task_at][from]", "in": "query", "description": "Filter leads by the date of the task closest to completion in Unix Timestamp format.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[closest_task_at][to]", "in": "query", "description": "Filter leads by the date of the task closest to completion in Unix Timestamp format.", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Request successful": { "value": "{\n \"_page\": 1,\n \"_links\": {\n \"self\": {\n \"href\": \"https://subdomain.kommo.com/api/v4/companies\"\n }\n },\n \"_embedded\": {\n \"companies\": [\n {\n \"id\": XXXXXX,\n \"name\": \"United\",\n \"responsible_user_id\": XXXXXX,\n \"group_id\": 0,\n \"created_by\": XXXXX,\n \"updated_by\": XXXXXX,\n \"created_at\": 1686670709,\n \"updated_at\": 1686670709,\n \"closest_task_at\": null,\n \"is_deleted\": false,\n \"custom_fields_values\": null,\n \"account_id\": XXXX123,\n \"_links\": {\n \"self\": {\n \"href\": \"https://subdomain.kommo.com/api/v4/companies/406320\"\n }\n },\n \"_embedded\": {\n \"tags\": []\n }\n },\n {\n \"id\": 510XXX,\n \"name\": \"Kommo\",\n \"responsible_user_id\": 837XYZ,\n \"group_id\": 0,\n \"created_by\": 0,\n \"updated_by\": 0,\n \"created_at\": 1686754687,\n \"updated_at\": 1686754687,\n \"closest_task_at\": null,\n \"is_deleted\": false,\n \"custom_fields_values\": null,\n \"account_id\": XYZ11263,\n \"_links\": {\n \"self\": {\n \"href\": \"https://subdomain.kommo.com/api/v4/companies/510864\"\n }\n },\n \"_embedded\": {\n \"tags\": []\n }\n },\n {\n \"id\": 597XXX,\n \"name\": \"Atme Co.\",\n \"responsible_user_id\": 0,\n \"group_id\": -1,\n \"created_by\": 0,\n \"updated_by\": 0,\n \"created_at\": 1686836351,\n \"updated_at\": 1686836351,\n \"closest_task_at\": null,\n \"is_deleted\": false,\n \"custom_fields_values\": null,\n \"account_id\": 3136XXXX,\n \"_links\": {\n \"self\": {\n \"href\": \"https://subdomain.kommo.com/api/v4/companies/597516\"\n }\n },\n \"_embedded\": {\n \"tags\": []\n }\n }\n ]\n }\n}" } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "The user is not authorized": { "value": "" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```