Kommo Leads
GET
https://rest.api.mktlab.app/v1/kommo/leads
Resposta
| Campo | Tipo | Descrição |
|---|---|---|
lead_id | string | ID único do lead no sistema Kommo. |
lead_name | string | Nome do lead, geralmente gerado automaticamente. |
status_id | string | ID do status do lead no sistema Kommo. |
price | number | Valor monetário associado ao lead (oportunidade). |
responsible_user_id | string | ID do usuário responsável pelo lead. |
group_id | string | ID do grupo ao qual o lead pertence. |
pipeline_id | string | ID do pipeline (funil de vendas) do lead. |
loss_reason_id | string ou null | ID da razão de perda do lead, se aplicável. |
created_by | string | ID do usuário que criou o lead. |
updated_by | string | ID do usuário que realizou a última atualização. |
created_at | Date | Data/hora de criação do lead (formato ISO 8601). |
updated_at | Date | Data/hora da última atualização do lead. |
closed_at | Date | Data/hora de fechamento do lead (caso tenha sido ganho ou perdido). |
closest_task_at | Date | Data/hora da próxima tarefa relacionada ao lead. |
is_deleted | boolean | Indica se o lead foi marcado como deletado. |
custom_fields_values | string | Valores de campos personalizados do lead. |
score | number | Pontuação do lead, se houver. |
account_id | string | ID da conta Kommo associada. |
labor_cost | number | Custo de mão de obra estimado para o lead. |
source_id | string | ID da fonte de origem do lead (ex: campanha, canal). |
tags | string | Lista de tags associadas, geralmente em formato stringificado de array de objetos. |
contacts_ids | string | IDs dos contatos vinculados ao lead, geralmente no formato {id1,id2,...}. |
loss_reason | string | Texto descritivo do motivo da perda do lead. |
tag_id | string | Lista de IDs das tags associadas ao lead. |
tag_name | string | Lista de nomes das tags associadas ao lead. |
tag_color | string | Lista de cores das tags associadas ao lead. |
tag_id_first | string | ID da primeira tag associada ao lead. |
tag_name_first | string | Nome da primeira tag associada ao lead. |
tag_color_first | string | Cor da primeira tag associada ao lead. |
integration_id | string | ID da integração da Kommo. |
project_id | string | ID do projeto da integração. |
unit_id | string | ID da unidade de negócio associada. |
document_id | string | ID de documento da integração. |
inserted_at | Date | Data/hora da inserção do registro no sistema (formato ISO 8601). |
Requisição
Parâmetros de Consulta
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://rest.api.mktlab.app/v1/kommo/leads' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"data": [
{
"lead_id": "1234567",
"lead_name": "Lead #1234567",
"status_id": "98765432",
"price": "1500.00",
"responsible_user_id": "11223344",
"group_id": "0",
"pipeline_id": "55667788",
"loss_reason_id": null,
"created_by": "99887766",
"updated_by": "99887766",
"created_at": "2025-06-01T10:20:30.000Z",
"updated_at": "2025-06-05T14:45:00.000Z",
"closed_at": null,
"closest_task_at": null,
"is_deleted": false,
"custom_fields_values": "None",
"score": null,
"account_id": "44556677",
"labor_cost": null,
"source_id": "12345.0",
"tags": "[{'id': 9999, 'name': 'Prioritário', 'color': '#FF5733'}]",
"contacts_ids": "{1234567}",
"loss_reason": null,
"tag_id": "['9999']",
"tag_name": "['Prioritário']",
"tag_color": "['#FF5733']",
"tag_id_first": "9999",
"tag_name_first": "Prioritário",
"tag_color_first": "#FF5733",
"integration_id": "abcd1234-5678-90ef-ghij-klmnopqrstuv",
"project_id": "abcdef1234567890abcdef12",
"unit_id": "unit1234567890abcdef",
"document_id": "doc1234567890abcdef",
"inserted_at": "2025-06-23T15:05:40.000Z"
}
],
"meta": {
"page": 1,
"limit": 500,
"total": 1,
"totalPages": 1,
"hasNextPage": false,
"hasPreviousPage": true
}
}Modificado em 2025-10-08 17:25:55