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

# Lista de Contatos

`GET /api/v4/contacts`

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

---

[API](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo.md) · [All operations](https://skmtc.net/kommo/apis/referencias-de-api-da-kommo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/referencias-de-api-da-kommo/revisions/98fdf05c2f5b/schema)