Kommo
Leads
GET
Retrieve Kommo leads with status, pipeline, pricing, source, and lifecycle timestamps.
Filters:
organizationId(required)integrationId(optional)leadId,statusId,pipelineIdresponsibleUserId,groupIdlossReasonIdcreatedStart,createdEndlastModifiedStart,lastModifiedEnd
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required)
integrationId?stringIntegration identifier (optional)
leadId?stringLead identifier (optional)
statusId?stringStatus identifier (optional)
responsibleUserId?stringResponsible user identifier (optional)
groupId?stringGroup identifier (optional)
pipelineId?stringPipeline identifier (optional)
lossReasonId?stringLoss reason identifier (optional)
createdStart?stringStart date/time for filtering (optional, ISO 8601 format)
Format
date-timecreatedEnd?stringEnd date/time for filtering (optional, ISO 8601 format)
Format
date-timelastModifiedStart?stringStart date/time for last update filtering (optional, ISO 8601 format)
Format
date-timelastModifiedEnd?stringEnd date/time for last update filtering (optional, ISO 8601 format)
Format
date-timepage?integerPage number for pagination (optional)
Default
1limit?integerNumber of items per page (optional, max 5000)
Range
value <= 5000Default
500Successful response
application/json- response
data?array<>meta?curl -X GET "https://example.com/v1/kommo/leads?organizationId=organization_123&createdStart=2026-01-01T00%3A00%3A00Z&createdEnd=2026-01-31T23%3A59%3A59Z&lastModifiedStart=2026-01-01T00%3A00%3A00Z&lastModifiedEnd=2026-01-31T23%3A59%3A59Z"{ "data": [ { "lead_id": "string", "status_id": "string", "price": 0, "responsible_user_id": "string", "group_id": "string", "pipeline_id": "string", "loss_reason_id": "string", "created_by": "string", "updated_by": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "closed_at": "2019-08-24T14:15:22Z", "closest_task_at": "2019-08-24T14:15:22Z", "is_deleted": true, "score": "string", "account_id": "string", "labor_cost": 0, "source_id": "string", "source_name": "string", "contacts_ids": "string", "integration_id": "string", "organization_id": "string", "document_id": "string", "inserted_at": "2019-08-24T14:15:22Z" } ], "meta": { "page": 0, "limit": 0, "hasNextPage": true, "hasPreviousPage": true }}