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

# Lista de contactos

`GET /api/v4/contacts`

Este método permite obtener una lista de contactos en la cuenta.

## Query parameters

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

## 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

- `401` — 401

---

[API](https://skmtc.net/kommo/apis/kommo-api.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api/versions/e291c0b2038d/schema)