Клиенты
Список клиентов
Клиенты магазина. Удалённые клиенты в список не попадают. Выручка в копейках. Право: customers:read.
Авторизация
bearerApiKey АвторизацияBearer <ключ>
Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API.
Где: header
Параметры запроса
filter[email]?string
Email, без учёта регистра.
filter[phone]?string
Телефон в любом формате: +7 916 123-45-67, 89161234567.
filter[updatedAt][from]?string
Изменены не раньше, ISO 8601 включительно.
Format
date-timefilter[updatedAt][to]?string
Изменены не позже, ISO 8601 включительно.
Format
date-timeorder?string
Сортировка. По умолчанию createdAt:desc. Для синхронизации берите updatedAt:asc.
Value in
- "createdAt:desc"
- "createdAt:asc"
- "updatedAt:desc"
- "updatedAt:asc"
cursor?string
Курсор из page.nextCursor предыдущего ответа. Работает только с той же сортировкой.
limit?integer
Размер страницы от 1 до 100. По умолчанию 50.
Ответ
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/customers"{ "data": [ { "id": "2c8e4a1f-9b3d-4f7e-a6c0-5d1b8e3f2a96", "name": "Анна Смирнова", "email": "anna@example.ru", "phone": "+7 (916) 123-45-67", "phoneDigits": "79161234567", "source": "order", "notes": "Предпочитает доставку после 18:00", "totalOrders": 4, "totalRevenue": 1164000, "firstSeenAt": "2026-03-02T10:21:00.000Z", "lastOrderAt": "2026-09-12T09:41:07.000Z", "createdAt": "2026-03-02T10:21:00.000Z", "updatedAt": "2026-09-12T09:41:07.000Z" } ], "page": { "nextCursor": null, "hasMore": false }}