--- updatedAt: 2026-06-11T12:12:58.000Z agentTools: projectIndex: https://pt-developers.kommo.com/llms.txt --- # Lista de Empresas O método permite obter uma lista de empresas. **Limitações**\ O método está disponível de acordo com os direitos do usuário. **Parâmetros “with”** | Parâmetro | Descrição | | :---------------- | :---------------------------------------------------------------------- | | leads | Adiciona informações sobre os leads vinculados ao contato na resposta | | contacts | Adiciona informações sobre os contatos vinculados à empresa na resposta | | catalog\_elements | Adiciona elementos das listas vinculados ao contato na resposta | **Cabeçalho de tipo de dado quando a solicitação é bem-sucedida**\ Content-Type: application/hal+json **Cabeçalho de tipo de dado em caso de erro**\ Content-Type: application/problem+json ## Parâmetros de resposta As propriedades de um objeto de empresa estão listadas abaixo.
Parâmetro Tipo de dado Descrição
id int ID da Empresa
name string Nome da Empresa
responsible_user_id int ID do usuário responsável pela empresa
group_id int ID do grupo do usuário responsável pela empresa
created_by int ID do usuário que criou a empresa
updated_by int ID do usuário que atualizou a empresa por último
created_at int Data de criação da empresa no formato de Unix Timestamp
updated_at int Data de atualização da empresa no formato de Unix Timestamp
closest_task_at int Data da tarefa aberta mais próxima no formato de Unix Timestamp
custom_fields_values array|null Um array dos valores dos campos personalizados atuais da empresa
account_id int ID da conta onde a empresa está localizada
* embedded object Dados das entidades incorporadas
* embedded[tags] array Array de dados das tags da empresa
* embedded[tags][0] object Modelo de tag da empresa
* embedded[tags][0][id] int ID da Tag
* embedded[tags][0][name] string Nome da Tag
* embedded[tags][0][color] string/null Cor da Tag
* embedded[contacts] array **O parâmetro GET “with” é obrigatório** Array de dados dos contatos vinculados
* embedded[contacts][0] object Dados do contato vinculado
* embedded[contacts][0][id] int ID do contato vinculado
* embedded[leads] array **O parâmetro GET “with” é obrigatório** Array de dados dos leads vinculados
* embedded[leads][0] object Dados do lead vinculado
* embedded[leads][0][id] int ID do lead vinculado
* embedded[catalog_elements][catalog_elements] array **O parâmetro GET “with” é obrigatório** Array de dados dos elementos de listas vinculadas
* embedded[catalog_elements][0] object Dados do elemento da lista vinculada
* embedded[catalog_elements][0][id] int ID do elemento vinculado
* embedded[catalog_elements][0][metadata] object Metadados do elemento
* embedded[catalog_elements][0][quantity] int Quantidade de elementos vinculados
* embedded[catalog_elements][0][catalog_id][catalog_id] int ID da lista do elemento vinculado
# OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "referencias-de-api-da-kommo", "version": "1.1" }, "servers": [ { "url": "https://{subdomain}.kommo.com", "variables": { "subdomain": { "default": "subdomain" } } } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v4/companies": { "get": { "summary": "Lista de Empresas", "description": "O método permite obter uma lista de empresas. ", "operationId": "lista-de-empresas", "parameters": [ { "name": "with", "in": "query", "description": "Este parâmetro aceita uma string que pode conter vários valores separados por vírgulas. Veja a tabela acima.", "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Página da resposta", "schema": { "type": "integer", "format": "int32" } }, { "name": "limit", "in": "query", "description": "O número de entidades retornadas na resposta de uma solicitação (limite – 250)", "schema": { "type": "integer", "format": "int32" } }, { "name": "query", "in": "query", "description": "Consulta de pesquisa (realizará uma busca pelos valores dos campos personalizados)", "schema": { "type": "string" } }, { "name": "order[updated_at]", "in": "query", "description": "Ordenação dos elementos da lista pelo horário em que as empresas foram atualizadas", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "order[id]", "in": "query", "description": "Ordenação dos elementos da lista", "schema": { "type": "string", "enum": [ "asc", "desc" ] } }, { "name": "filter[id][]", "in": "query", "description": "Filtro pelo ID do usuário que adicionou a empresa", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[name][]", "in": "query", "description": "Filtrar por Nome da Empresa", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "filter[created_by][]", "in": "query", "description": "Filtro pelo ID do usuário que adicionou a empresa", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[updated_by][]", "in": "query", "description": "Filtro pelo ID do usuário que atualizou a empresa por último", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[responsible_user_id][]", "in": "query", "description": "Filtro pelo ID do usuário responsável pela empresa", "schema": { "type": "array", "items": { "type": "integer", "format": "int32" } } }, { "name": "filter[created_at][from]", "in": "query", "description": "Filtro pela data de criação da empresa no formato Unix Timestamp. Como resposta, você receberá todas as empresas adicionadas após essa data.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[created_at][to]", "in": "query", "description": "Filtro pela data de criação da empresa no formato Unix Timestamp. Como resposta, você receberá todas as empresas adicionadas antes dessa data.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][from]", "in": "query", "description": "Filtro pela data em que a empresa foi atualizada no formato Unix Timestamp. Como resposta, você receberá todas as empresas atualizadas após essa data.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[updated_at][to]", "in": "query", "description": "Filtro pela data em que a empresa foi atualizada no formato Unix Timestamp. Como resposta, você receberá todas as empresas atualizadas antes dessa data.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[closest_task_at][from]", "in": "query", "description": "Filtro de leads pela data da tarefa mais próxima da conclusão no formato Unix Timestamp.", "schema": { "type": "integer", "format": "int32" } }, { "name": "filter[closest_task_at][to]", "in": "query", "description": "Filtro de leads pela data da tarefa mais próxima da conclusão no formato Unix Timestamp.", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Solicitação bem-sucedida": { "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": { "Usuário não autorizado": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } } } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```