Skip to main content

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

​
Authorization
string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
​
Seller-Id
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
​
School-Id
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
POST /saas/v2/user/find-many
Требуется аутентификация и право SchoolManageUsers.

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

Передайте хотя бы один из списков идентификаторов
Метод возвращает массив найденных пользователей. Пользователи, которых не удалось найти, в ответ не включаются — сопоставляйте результат с запросом по email/phone/tgId/extId на своей стороне.
​
logins
string[]
Список логинов пользователей: email, телефон в международном формате или домен id12345. От 2 до 50 символов каждый, максимум 250 элементов.
​
tgIds
integer[]
Список Telegram ID пользователей. Максимум 250 элементов.
​
extIds
string[]
Список внешних идентификаторов из вашей системы. От 1 до 50 символов каждый, максимум 250 элементов.
Необходимо передать хотя бы один непустой список. Каждый список ограничен 250 элементами.
curl --location 'https://api.exode.biz/saas/v2/user/find-many' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "logins": ["[email protected]", "+9876543210"]
  }'

{
  "success": true,
  "code": 201,
  "payload": {
    "users": [
      {
        "id": 1683,
        "createdAt": "2026-07-02T11:15:46.896Z",
        "updatedAt": "2026-07-02T11:15:46.940Z",
        "archivedAt": null,
        "uuid": "e-cjTT0CWMCB",
        "active": true,
        "activated": true,
        "banned": false,
        "alive": true,
        "domain": "id1683",
        "email": "[email protected]",
        "phone": null,
        "tgId": null,
        "vkId": null,
        "appleId": null,
        "extId": "crm_12345",
        "schoolId": 198,
        "language": null,
        "timezone": null,
        "lastOnlineAt": null,
        "starsBalance": 0,
        "currentTime": "2026-07-02T11:15:46+00:00",
        "isSleepingNow": false,
        "profile": {
          "id": 1665,
          "createdAt": "2026-07-02T11:15:46.932Z",
          "updatedAt": "2026-07-02T11:15:46.932Z",
          "archivedAt": null,
          "userId": 1683,
          "official": false,
          "firstName": "Firstname",
          "lastName": "Lastname",
          "fullName": "Firstname Lastname",
          "fullNameShort": "Firstname L.",
          "bdate": null,
          "sex": "Ufo",
          "country": null,
          "city": null,
          "role": "Student",
          "status": null,
          "title": "",
          "emojiTitle": "",
          "avatar": {
            "id": 1665,
            "small": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/small/avatar.png",
            "medium": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/medium/avatar.png",
            "maximum": "https://storage.exode.biz/production/user/1683/xK2mVwNib9b0/avatar.png"
          },
          "titleState": {
            "manualTitle": null,
            "manualEmojiTitle": null,
            "manualNextTitle": null,
            "manualNextEmojiTitle": null,
            "manualExpiredAt": null,
            "locationTitle": null,
            "locationEmojiTitle": null,
            "achievementTitle": null,
            "achievementEmojiTitle": null
          }
        }
      }
    ]
  }
}

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

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