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

200200

204204

400400

401401

429429

500500