Kommo
Contacts
GET
Retrieve Kommo contacts with identifiers, lifecycle fields, and related leads.
Filters:
organizationId(required)integrationId(optional)createdStart,createdEndlastModifiedStart,lastModifiedEnd
ClientIdAuthClientSecretAuthheader
x-client-id<token>Client ID
header
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required)
integrationId?stringIntegration 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/contacts?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": [ { "id": "string", "responsible_user_id": "string", "group_id": "string", "created_by": "string", "updated_by": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "closest_task_at": "2019-08-24T14:15:22Z", "is_deleted": true, "is_unsorted": true, "id_leads": "string", "email": "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 }}