Skip to main content

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

string
обязательно
API-токен сервисного пользователя в формате Bearer YOUR_TOKEN. Токен выпускает владелец школы в кабинете: Управление → Школа → Для разработчиков → API-ключи — подробнее в разделе «Аутентификация».
integer
обязательно
Числовой ID продавца — аккаунта, которому принадлежит школа. Скопируйте его на странице API-ключи в карточке «Данные для интеграции → Идентификаторы». По этому ID проверяются права токена.
integer
обязательно
Числовой ID школы, берётся там же, где Seller-Id. Значение должно совпадать со школой продавца — иначе вернётся ошибка 400 с cause: "ForbiddenSchoolMismatch".
Требуется аутентификация и право «Управление пользователями школы» (SchoolManageUsers).
Нужно найти одного пользователя — используйте Поиск по идентификатору.

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

Передайте хотя бы один из списков идентификаторов
Метод возвращает массив найденных пользователей. Пользователи, которых не удалось найти, в ответ не включаются — сопоставляйте результат с запросом по email/phone/domain/tgId/extId на своей стороне. Если передано несколько списков, условия объединяются через «ИЛИ»: в ответ попадает пользователь, совпавший хотя бы с одним значением из любого списка, — каждый пользователь не более одного раза. Порядок элементов в ответе не соответствует порядку в запросе.
string[]
Список логинов пользователей: email, телефон в международном формате или доменный логин (domain, например i_ivanov; значение вида id12345 ищет пользователя с ID 12345). От 2 до 50 символов каждый, максимум 250 элементов.
integer[]
Список Telegram ID пользователей. Максимум 250 элементов.
string[]
Список внешних идентификаторов из вашей системы. От 1 до 50 символов каждый, максимум 250 элементов.
Необходимо передать хотя бы один непустой список. Каждый список ограничен 250 элементами.

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

Для поиска пользователей требуется право «Управление пользователями школы» (SchoolManageUsers).
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.

Обновлено: 2026-09-25 13:43 UTC