GET /clients — найти клиентов

Два режима: точный поиск по почте или телефону — одна карточка или пусто; и список с поиском. Право — clients:read.

Есть ли такой клиент

curl "https://app.deskus.ru/api/v1/clients?email=MARIA@example.com" \
  -H "Authorization: Bearer $DESKUS_KEY"

Ответ 200

{
  "data": [
    {
      "id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
      "name": "Мария Котова",
      "email": "maria@example.com",
      "phone": "+79001234567",
      "company": null,
      "city": "Казань",
      "is_vip": false,
      "created_at": "2026-10-21T09:15:04.102Z",
      "updated_at": "2026-10-21T09:15:04.102Z"
    }
  ],
  "next_cursor": null
}

• Узнавание — то же, что при приёме обращений: почта без учёта регистра, телефон по последним цифрам, объединённая карточка ведёт к основной.

• Переданы и почта, и телефон — сначала ищем по почте.

• Не нашли — { "data": [], "next_cursor": null }.

Список

curl "https://app.deskus.ru/api/v1/clients?q=котова&created_since=2026-10-01T00:00:00Z" \
  -H "Authorization: Bearer $DESKUS_KEY"

Удалённые и объединённые с другими карточки в списке не показываются.