---
title: "Отримати список клієнтів"
method: GET
path: "/clients"
tags: ["Clients"]
---

# Отримати список клієнтів

`GET /clients`

**Метод повертає список клієнтів/лідів згідно з налаштованими фільтрами.** <br/>Присутня пагінація по 25 елементів на сторінці, нові елементи знаходяться зверху, старі - знизу.<br/> [Детальніше про фільтрування](https://keepincrm.com/api-custom-filters)

## Query parameters

- `q[source_id_eq]` string
- `q[registered_at_lteq]` string
- `q[registered_at_gteq]` string
- `q[trigram_idx_cont]` string
- `page` integer

## Response `200`

Успішна відповідь

- object
  - `items` Client[]
    - `id` integer — Ідентифікатор
    - `company` string — Назва компанії (якщо не заповнено, то буде взято значення ПІБ клієнта)
    - `person` string — ПІБ клієнта
    - `email` string — Email
    - `phones` string[] — Список телефонів
    - `lead` boolean — Це лід?
    - `important` boolean — Важливо
    - `comment` string — Коментар
    - `contractor_id` number — Ідентифікатор підрядника
    - `source` Source — Дані джерела
      - `id` number — Ідентифікатор
      - `name` string, required — Назва
      - `color` string — Колір
    - `main_responsible` User — Дані працівника (користувача)
      - `id` integer — Ідентифікатор
      - `name` string, required — Імʼя працівника
    - `tag_names` string[] — Теги
    - `custom_fields` CustomField[]
      - `name` string, required — Назва поля
      - `value` string, required — Значення поля
    - `contacts` Contact[]
      - `fullname` string, required — ПІБ
      - `email` string — Email
      - `phones` string[] — Список телефонів
      - `custom_fields` CustomField[]
        - `name` string, required — Назва поля
        - `value` string, required — Значення поля
  - `pagination` object
    - `total_count` integer — Загальна кількість
    - `total_pages` integer — Всього сторінок
    - `current_page` integer — Поточна сторінка

## Other responses

- `401` — Невірний APIKey

---

[API](https://skmtc.dev/keepincrm/apis/keepincrm-api.md) · [All operations](https://skmtc.dev/keepincrm/apis/keepincrm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keepincrm/keepincrm-api/revisions/d0be1723749a/schema)