--- updatedAt: 2026-05-26T12:17:24.000Z agentTools: projectIndex: https://es-developers.kommo.com/llms.txt --- # Obtener un lead por su ID Este método permite obtener los datos específicos de un lead mediante su ID. | Parámetro with | Descripción | | :----------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | catalog\_elements | Añade elementos de listas vinculados al lead en la respuesta. | | is\_price\_modified\_by\_robot | Añade una propiedad que representa si el valor de la venta del lead fue cambiado por el Robot en la última acción a la respuesta. | | loss\_reason | Añade información detallada sobre el motivo de pérdida del lead a la respuesta. | | contacts | Añade información sobre los contactos asociados con el lead a la respuesta. | | only\_deleted | Si se pasa este parámetro, la solicitud del método retornará solo los leads eliminados que aún podrán ser restaurados en la respuesta. Recibirás modelos de leads con las siguientes propiedades: parámetros “id”, fecha de modificación y “is\_deleted” = true. | | source\_id | Añade el ID de la fuente del lead a la respuesta. | | source | Añade en la respuesta información sobre la fuente, su ID y nombre | **Limitaciones**\ El método está disponible de acuerdo con los permisos del usuario. **Tipo de autorización**\ OAuth 2.0 con Token de acceso/ Token de larga duración. **Encabezado de tipo de datos cuando la solicitud es exitosa**\ Content-Type: application/hal+json. **Encabezado de tipo de datos en caso de un error**\ Content-Type: application/problem+json. **Parámetros de respuesta**
Parámetro Tipo de dato Descripción
id int ID del contacto.
name string Nombre del contacto.
price int Venta del lead.
responsible_user_id int ID del usuario responsable del lead.
group_id int ID del grupo del usuario responsable del lead.
status_id int ID de la etapa a la que se añade el lead, por defecto a la primera etapa del pipeline principal.
pipeline_id int ID del pipeline al que se añade el lead.
loss_reason_id int ID del motivo de pérdida del lead.
source_id int **El parámetro GET “with” es obligatorio.** ID de la fuente del lead.
created_by int ID del usuario que creó el lead.
updated_by int ID del usuario que actualizó el lead.
created_at int La fecha y hora en que se creó el lead en formato Unix Timestamp.
updated_at int La fecha y hora en que se actualizó el lead en formato Unix Timestamp.
closed_at int La fecha y hora en que se cerró el lead en formato Unix Timestamp.
closest_task_at int La fecha y hora de la tarea abierta más recientemente en formato Unix Timestamp.
custom_fields_values array|null Un arreglo que contiene información sobre los valores de campos personalizados especificados para este lead.
score int|null Puntuación del lead.
account_id int ID de la cuenta donde se encuentra el lead.
labor_cost int Muestra cuánto tiempo se ha dedicado trabajar en la negociación. Calcula el tiempo en segundos.
is_price_modified_by_robot bool **El parámetro GET “with” es obligatorio.** Define si el valor de venta del lead fue cambiado por el Robot en la última ocasión.
* embedded object Datos de entidades asociadas.
* embedded[loss_reason][loss_reason] object **El parámetro GET “with” es obligatorio.** Motivo de pérdida del lead.
* embedded[loss_reason][id] int ID del motivo de pérdida.
* embedded[loss_reason][name] string Nombre del motivo de pérdida.
* embedded[tags] array Arreglo de datos de etiquetas del lead.
* embedded[tags][0] object Modelo de etiqueta del lead.
* embedded[tags][0][id] int ID de la etiqueta.
* embedded[tags][0][name] string Nombre de la etiqueta.
* embedded[tags][0][color] string/null Color de la etiqueta.
* embedded[contacts] array **El parámetro GET “with” es obligatorio.** Arreglo de datos de contactos asociados.
* embedded[contacts][0] object Datos del contacto asociado.
* embedded[contacts][0][id] ints ID del contacto asociado.
* embedded[contacts][0][is_main][is_main] bool Define si el contacto es principal para el lead.
* embedded[companies] array Arreglo de datos de la compañía asociada. Este arreglo siempre tiene 1 elemento, ya que un lead solo puede estar asociado a 1 compañía.
* embedded[companies][0] object Datos de la compañía asociada.
* embedded[companies][0][id] int ID de la compañía asociadaa.
* embedded[catalog_elements][catalog_elements] array **El parámetro GET “with” es obligatorio.** Arreglo de datos de los elementos de listas asociadas.
* embedded[catalog_elements][0] object Datos del elemento de la lista asociada.
* embedded[catalog_elements][0][id] int ID del elemento asociado.
* embedded[catalog_elements][0][metadata] object Metadatos del elemento.
* embedded[catalog_elements][0][quantity] int Cantidad de elementos asociados.
* embedded[catalog_elements][0][catalog_id][catalog_id] int ID de la lista asociada al elemento.
* embedded[source] object Se requiere el parámetro GET "with". Fuente del lead
* embedded[source][id] int ID de la fuente del lead
* embedded[source][name] string Nombre de la fuente del lead
# OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "kommo-api", "version": "1.0" }, "servers": [ { "url": "https://{subdominio}.kommo.com", "variables": { "subdominio": { "default": "subdominio" } } } ], "components": { "securitySchemes": { "sec0": { "type": "oauth2", "flows": {} } } }, "security": [ { "sec0": [] } ], "paths": { "/api/v4/leads/{id}": { "get": { "summary": "Obtener un lead por su ID", "description": "Este método permite obtener los datos específicos de un lead mediante su ID.", "operationId": "obtener-un-lead-por-su-id", "parameters": [ { "name": "id", "in": "path", "description": "ID del lead", "schema": { "type": "integer", "format": "int32" }, "required": true }, { "name": "with", "in": "query", "description": "Este parámetro acepta una cadena que puede contener varios valores (ver la tabla de arriba) separados por comas", "schema": { "type": "string" } } ], "responses": { "200": { "description": "200", "content": { "application/json": { "examples": { "Solicitud exitosa": { "value": "{\n \"id\": 152464,\n \"name\": \"Ejemplo lead 2\",\n \"price\": 20000,\n \"responsible_user_id\": 8375357,\n \"group_id\": 0,\n \"status_id\": 58141807,\n \"pipeline_id\": 6950551,\n \"loss_reason_id\": null,\n \"created_by\": 0,\n \"updated_by\": 8375357,\n \"created_at\": 1686673337,\n \"updated_at\": 1686748504,\n \"closed_at\": null,\n \"closest_task_at\": null,\n \"is_deleted\": false,\n \"custom_fields_values\": [\n {\n \"field_id\": 184994,\n \"field_name\": \"Venta\",\n \"field_code\": null,\n \"field_type\": \"checkbox\",\n \"values\": [\n {\n \"value\": true\n }\n ],\n \"is_computed\": false\n }\n ],\n \"score\": null,\n \"account_id\": 31361463,\n \"labor_cost\": null,\n \"is_price_computed\": false,\n \"_links\": {\n \"self\": {\n \"href\": \"https://devteam.kommo.com/api/v4/leads/152464?page=1&limit=50\"\n }\n },\n \"_embedded\": {\n \"tags\": [\n {\n \"id\": 2164,\n \"name\": \"Ex\",\n \"color\": null\n }\n ],\n \"companies\": []\n }\n}" } }, "schema": { "type": "object", "properties": { "id": { "type": "integer", "example": 152464, "default": 0 }, "name": { "type": "string", "example": "Ejemplo lead 2" }, "price": { "type": "integer", "example": 20000, "default": 0 }, "responsible_user_id": { "type": "integer", "example": 8375357, "default": 0 }, "group_id": { "type": "integer", "example": 0, "default": 0 }, "status_id": { "type": "integer", "example": 58141807, "default": 0 }, "pipeline_id": { "type": "integer", "example": 6950551, "default": 0 }, "loss_reason_id": {}, "created_by": { "type": "integer", "example": 0, "default": 0 }, "updated_by": { "type": "integer", "example": 8375357, "default": 0 }, "created_at": { "type": "integer", "example": 1686673337, "default": 0 }, "updated_at": { "type": "integer", "example": 1686748504, "default": 0 }, "closed_at": {}, "closest_task_at": {}, "is_deleted": { "type": "boolean", "example": false, "default": true }, "custom_fields_values": { "type": "array", "items": { "type": "object", "properties": { "field_id": { "type": "integer", "example": 184994, "default": 0 }, "field_name": { "type": "string", "example": "Venta" }, "field_code": {}, "field_type": { "type": "string", "example": "checkbox" }, "values": { "type": "array", "items": { "type": "object", "properties": { "value": { "type": "boolean", "example": true, "default": true } } } }, "is_computed": { "type": "boolean", "example": false, "default": true } } } }, "score": {}, "account_id": { "type": "integer", "example": 31361463, "default": 0 }, "labor_cost": {}, "is_price_computed": { "type": "boolean", "example": false, "default": true }, "_links": { "type": "object", "properties": { "self": { "type": "object", "properties": { "href": { "type": "string", "example": "https://devteam.kommo.com/api/v4/leads/152464?page=1&limit=50" } } } } }, "_embedded": { "type": "object", "properties": { "tags": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer", "example": 2164, "default": 0 }, "name": { "type": "string", "example": "Ex" }, "color": {} } } }, "companies": { "type": "array" } } } } } } } }, "204": { "description": "204", "content": { "text/plain": { "examples": { "El lead con el ID especificado no existe": { "value": "" } } } } }, "400": { "description": "400", "content": { "application/json": { "examples": { "Solicitud incorrecta": { "value": "{}" } }, "schema": { "type": "object", "properties": {} } } } }, "401": { "description": "401", "content": { "text/plain": { "examples": { "El usuario no está autorizado": { "value": "{\n \"title\": \"No autorizado\",\n \"type\": \"https://httpstatus.es/401\",\n \"status\": 401,\n \"detail\": \"Nombre de usuario o contraseña incorrectos\"\n}" } }, "schema": { "type": "object", "properties": { "title": { "type": "string", "example": "No autorizado" }, "type": { "type": "string", "example": "https://httpstatus.es/401" }, "status": { "type": "integer", "example": 401, "default": 0 }, "detail": { "type": "string", "example": "Nombre de usuario o contraseña incorrectos" } } } } } }, "429": { "description": "429", "content": { "text/plain": { "examples": { "Demasiadas solicitudes": { "value": "" } } } } }, "500": { "description": "500", "content": { "text/plain": { "examples": { "Error interno del servidor": { "value": "" } } } } } }, "deprecated": false } } }, "x-readme": { "headers": [ { "key": "Content-Type", "value": "application/json" } ], "explorer-enabled": true, "proxy-enabled": true }, "x-readme-fauxas": true } ```