Kommo

Contatos

GET
/v1/kommo/contacts

Retorna contatos do Kommo com identificadores, campos de ciclo de vida e leads relacionados.

Filtros:

  • organizationId (obrigatório)
  • integrationId (opcional)
  • createdStart, createdEnd
  • lastModifiedStart, lastModifiedEnd

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório)

integrationId?string

Identificador da integração (opcional)

createdStart?string

Data/hora inicial para filtragem (opcional, formato ISO 8601)

Formatodate-time
createdEnd?string

Data/hora final para filtragem (opcional, formato ISO 8601)

Formatodate-time
lastModifiedStart?string

Data/hora inicial para filtro de última atualização (opcional, formato ISO 8601)

Formatodate-time
lastModifiedEnd?string

Data/hora final para filtro de última atualização (opcional, formato ISO 8601)

Formatodate-time
page?integer

Número da página para paginação (opcional)

Padrão1
limit?integer

Número de itens por página (opcional, máx. 5000)

Intervalovalue <= 5000
Padrão500

Corpo da resposta

Resposta de sucesso

application/json
  1. 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  }}