--- updatedAt: 2025-07-22T09:06:45.000Z agentTools: projectIndex: https://pt-developers.kommo.com/llms.txt --- # Obtendo um contato pelo seu ID Este método permite obter os dados de um contato específico pelo seu ID **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 | | 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**
Parâmetro Tipo de dado Descrição
id int ID de Contato
name string Nome completo do Contato
first\_name string Primeiro nome do Contato
last\_name string Último nome do Contato
responsible\_user\_id int ID do usuário responsável pelo Contato
group\_id int ID do Grupo do usuário responsável pelo Contato
created\_by int ID do usuário que criou o Contato
updated\_by int ID do usuário que atualizou o Contato pela última vez
created\_at int Data de criação do Contato no formato Unix Timestamp
updated\_at int Data de atualização do Contato no formato Unix Timestamp
closest\_task\_at int Data da tarefa aberta mais próxima no formato Unix Timestamp
custom\_fields\_values array|null Um array dos valores dos campos personalizados atuais do contato
account\_id int ID da conta onde o contato está localizado
* embedded object Dados das entidades incorporadas
* embedded[tags] array Array de dados das Tags do contato
* embedded[tags][0] object Modelo da Tag do contato
* 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[companies] array Array de dados da empresa vinculada. Este array sempre consiste em 1 elemento.
* embedded[companies][0] object Dados da Empresa vinculada
* embedded[companies][0][id] int ID da Empresa vinculada
* 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 das listas vinculadas
* embedded[catalog\_elements][0] object Dados do elemento vinculado da lista
* 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/contacts/{id}": { "get": { "summary": "Obtendo um contato pelo seu ID", "description": "Este método permite obter os dados de um contato específico pelo seu ID", "operationId": "obtendo-um-contato-pelo-seu-id", "parameters": [ { "name": "id", "in": "path", "description": "ID do Contato", "schema": { "type": "integer", "format": "int32" }, "required": true }, { "name": "with", "in": "query", "description": "Este parâmetro aceita uma string que pode consistir em vários valores separados por vírgulas.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Solicitação bem-sucedida": { "value": "{\n \"id\": 3,\n \"name\": \"João Silva\",\n \"first_name\": \"João\",\n \"last_name\": \"Silva\",\n \"responsible_user_id\": 504141,\n \"group_id\": 0,\n \"created_by\": 504141,\n \"updated_by\": 504141,\n \"created_at\": 1582117331,\n \"updated_at\": 1590943929,\n \"closest_task_at\": null,\n \"custom_fields_values\": [\n {\n \"field_id\": 3,\n \"field_name\": \"Telefone de trabalho\",\n \"field_code\": \"PHONE\",\n \"field_type\": \"multitext\",\n \"values\": [\n {\n \"value\": \"+14155551234\",\n \"enum_id\": 1,\n \"enum\": \"WORK\"\n }\n ]\n }\n ],\n \"account_id\": 28805383,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.amocrm.com/api/v4/contacts/3\"\n }\n },\n \"_embedded\": {\n \"tags\": [],\n \"leads\": [\n {\n \"id\": 1,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.amocrm.com/api/v4/leads/1\"\n }\n }\n },\n {\n \"id\": 3916883,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.amocrm.com/api/v4/leads/3916883\"\n }\n }\n }\n ],\n \"customers\": [\n {\n \"id\": 134923,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.amocrm.com/api/v4/customers/134923\"\n }\n }\n }\n ],\n \"catalog_elements\": [],\n \"companies\": [\n {\n \"id\": 1,\n \"_links\": {\n \"self\": {\n \"href\": \"https://example.amocrm.com/api/v4/companies/1\"\n }\n }\n }\n ]\n }\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "integer", "example": 3, "default": 0 }, "name": { "type": "string", "example": "João Silva" }, "first_name": { "type": "string", "example": "João" }, "last_name": { "type": "string", "example": "Silva" }, "responsible_user_id": { "type": "integer", "example": 504141, "default": 0 }, "group_id": { "type": "integer", "example": 0, "default": 0 }, "created_by": { "type": "integer", "example": 504141, "default": 0 }, "updated_by": { "type": "integer", "example": 504141, "default": 0 }, "created_at": { "type": "integer", "example": 1582117331, "default": 0 }, "updated_at": { "type": "integer", "example": 1590943929, "default": 0 }, "closest_task_at": {}, "custom_fields_values": { "type": "array", "items": { "type": "object", "properties": { "field_id": { "type": "integer", "example": 3, "default": 0 }, "field_name": { "type": "string", "example": "Telefone de trabalho" }, "field_code": { "type": "string", "example": "PHONE" }, "field_type": { "type": "string", "example": "multitext" }, "values": { "type": "array", "items": { "type": "object", "properties": { "value": { "type": "string", "example": "+14155551234" }, "enum_id": { "type": "integer", "example": 1, "default": 0 }, "enum": { "type": "string", "example": "WORK" } } } } } } }, "account_id": { "type": "integer", "example": 28805383, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.amocrm.com/api/v4/contacts/3" } } } } }, "_embedded": { "type": "object", "properties": { "tags": { "type": "array" }, "leads": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 1, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.amocrm.com/api/v4/leads/1" } } } } } } } }, "customers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 134923, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.amocrm.com/api/v4/customers/134923" } } } } } } } }, "catalog_elements": { "type": "array" }, "companies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 1, "default": 0 }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://example.amocrm.com/api/v4/companies/1" } } } } } } } } } } } } } } }, "204": { "description": "204", "content": { "application/json": { "examples": { "The contact with the specified ID does not exist": { "value": "No Content" } } } } }, "401": { "description": "401", "content": { "application/json": { "examples": { "Usuário não autorizado": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } } }, "deprecated": false } } }, "x-readme": { "headers": [], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```