---
title: "Lista de Contatos"
method: GET
path: "/api/v4/contacts"
---

# Lista de Contatos

`GET /api/v4/contacts`

## Request

- Base URL: `https://subdomain.kommo.com`
- URL: `https://subdomain.kommo.com/api/v4/contacts`
- Auth: OAuth 2

Este método permite obter uma lista de contatos na conta

## Path parameters

- `with` string, required
- `page` integer, required
- `limit` integer, required
- `query` string, required
- `order[updated_at]` 'asc' | 'desc', required
- `order[id]` 'asc' | 'desc', required
- `filter[id][]` integer[], required
- `filter[name][]` string[], required
- `filter[created_by][]` integer[], required
- `filter[updated_by][]` integer[], required
- `filter[responsible_user_id][]` integer[], required
- `filter[created_at][from]` integer, required
- `filter[created_at][from]` integer, required
- `filter[updated_at][from]` integer, required
- `filter[updated_at][to]` integer, required
- `filter[closest_task_at][from]` integer, required
- `filter[closest_task_at][to]` integer, required

## Response `200`

200

- object
  - `_page` integer
  - `_links` object
    - `self` object
      - `href` string
  - `_embedded` object
    - `contacts` object[]
      - `id` integer
      - `name` string
      - `first_name` string
      - `last_name` string
      - `responsible_user_id` integer
      - `group_id` integer
      - `created_by` integer
      - `updated_by` integer
      - `created_at` integer
      - `updated_at` integer
      - `closest_task_at` unknown
      - `is_deleted` boolean
      - `is_unsorted` boolean
      - `custom_fields_values` object[]
        - `field_id` integer
        - `field_name` string
        - `field_code` string
        - `field_type` string
        - `values` object[]
          - `value` string
          - `enum_id` integer
          - `enum_code` string
      - `account_id` integer
      - `_links` object
        - `self` object
          - `href` string
      - `_embedded` object
        - `tags` unknown[]
          - unknown
        - `companies` object[]
          - `id` integer
          - `_links` object
            - `self` object
              - …

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `55101699dddb`: 1 breaking, 1 warning
  - added the new path request parameter `filter[created_at][from]`
  - deleted the `path` request parameter `filter[created_at][from]`

[Operation history](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/changes/api/v4/contacts/get.md)

---

[API](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo.md) - [All operations](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/llms.txt) - [OpenAPI document](https://skmtc.dev/kommo/apis/referencias-de-api-da-kommo/revisions/55101699dddb?raw)