Skip to main content

Заголовки запроса

string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Требуется аутентификация и право SchoolManageUsers.
Все параметры фильтрации необязательны. Без фильтров метод вернёт всех пользователей школы с учётом пагинации. Каждый элемент ответа — объект userWithProfile (пользователь с вложенным профилем).
Параметры-массивы передаются повторением параметра: statuses=Active&statuses=OnLeave. Диапазоны дат — вложенными полями: createdAtDateRange[from]=2026-01-01&createdAtDateRange[to]=2026-02-01.

Параметры запроса

Пагинация

integer
Количество записей на странице. От 1 до 1000. По умолчанию 100.
integer
Номер страницы (начиная с 1). Альтернатива skip.
integer
Количество записей, которые нужно пропустить. По умолчанию 0.

Фильтрация

Поиск по имени, фамилии, email, телефону и доменному логину. Максимум 50 символов.
enum[]
Фильтр по статусам учётной записи: Active, OnLeave, Banned, Blocked, Terminated, Deleted. Описание статусов — в справочнике user.
boolean
Фильтр по признаку подтверждённого входа (true/false).
boolean
Фильтр по архивности: true — только архивированные, false — только неархивированные.
integer[]
Фильтр по ID пользователей.
string[]
Фильтр по внешним идентификаторам из вашей системы. От 1 до 50 символов каждый, максимум 250 элементов.
object
Диапазон даты создания: createdAtDateRange[from], createdAtDateRange[to] (ISO 8601).
object
Диапазон последней активности: lastOnlineAtDateRange[from], lastOnlineAtDateRange[to] (ISO 8601).
object
Фильтр по UTM-меткам регистрации. Поле value — массив пар { key, value } (непустые строки).
object
Диапазон даты архивации (удаления): archivedAtDateRange[from], archivedAtDateRange[to] (ISO 8601).
integer[]
Фильтр по ID пользователей, выполнивших архивацию (удаление).
object
Вложенный фильтр по профилю.

Сортировка

enum
Сортировка по ID: ASC или DESC.
enum
Сортировка по дате создания: ASC или DESC.
enum
Сортировка по последней активности: ASC или DESC.
enum
Сортировка по дате обновления: ASC или DESC.
enum
Сортировка по балансу «звёзд»: ASC или DESC.
enum
Сортировка по количеству доступов к продуктам: ASC или DESC.
enum
Сортировка по дате архивации: ASC или DESC.
enum
Сортировка по внутреннему порядку: ASC или DESC.

Поля ответа

object
Постраничный список пользователей. Структура элемента — в справочнике user.

Требования к правам доступа

Требуется аутентификация по токену и право управления пользователями школы (SchoolManageUsers).

Обновлено: 2026-07-22 12:19 UTC