Find by a list of identifiers

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"]
  }'

const axios = require('axios');

const findManyUsers = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/user/find-many', {
      logins: ['[email protected]', '+9876543210']
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Users found:', response.data.payload.users);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

findManyUsers();

import requests
import json

url = 'https://api.exode.biz/saas/v2/user/find-many'

data = {
  'logins': ['[email protected]', '+9876543210']
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
response.raise_for_status()

result = response.json()
print(json.dumps(result['payload']['users'], indent=2, ensure_ascii=False))

{
  "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,
        "status": "Active",
        "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
          }
        }
      }
    ]
  }
}

{
  "success": true,
  "code": 201,
  "payload": {
    "users": []
  }
}

{
  "cause": "validation",
  "code": 400,
  "success": false,
  "error": "Bad Request",
  "message": [
    "logins should not be empty"
  ]
}

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"]
  }'

const axios = require('axios');

const findManyUsers = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/user/find-many', {
      logins: ['[email protected]', '+9876543210']
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Users found:', response.data.payload.users);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

findManyUsers();

import requests
import json

url = 'https://api.exode.biz/saas/v2/user/find-many'

data = {
  'logins': ['[email protected]', '+9876543210']
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
response.raise_for_status()

result = response.json()
print(json.dumps(result['payload']['users'], indent=2, ensure_ascii=False))

{
  "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,
        "status": "Active",
        "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
          }
        }
      }
    ]
  }
}

{
  "success": true,
  "code": 201,
  "payload": {
    "users": []
  }
}

{
  "cause": "validation",
  "code": 400,
  "success": false,
  "error": "Bad Request",
  "message": [
    "logins should not be empty"
  ]
}

Request headers

string

required

The service user’s API token in the Bearer YOUR_TOKEN format. The school owner issues the token in the admin panel: Manage → School → For developers → API keys — see the “Authentication” section for details.

integer

required

The numeric ID of the seller — the account the school belongs to. Copy it on the API keys page, in the Integration data → Identifiers card. The token’s permissions are checked against this ID.

integer

required

The numeric ID of the school, found in the same place as Seller-Id. The value must match the seller’s school — otherwise a 400 error with cause: "ForbiddenSchoolMismatch" is returned.

POST /saas/v2/user/find-many

Requires authentication and the “School User Management” permission (SchoolManageUsers).

To find a single user, use Find by identifier.

Request parameters

Pass at least one of the identifier lists

The method returns an array of found users. Users that could not be found are not included in the response — match the result to the request by email/phone/domain/tgId/extId on your side. If several lists are passed, the conditions are combined with “OR”: the response includes every user matching at least one value from any list — each user at most once. The order of items in the response does not match the order in the request.

string[]

A list of user logins: email, phone in international format, or domain login (domain, for example i_ivanov; a value like id12345 finds the user with ID 12345). From 2 to 50 characters each, up to 250 items.

integer[]

A list of users’ Telegram IDs. Up to 250 items.

string[]

A list of external identifiers from your system. From 1 to 50 characters each, up to 250 items.

You must pass at least one non-empty list. Each list is limited to 250 items.

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"]
  }'

const axios = require('axios');

const findManyUsers = async () => {
  try {
    const response = await axios.post('https://api.exode.biz/saas/v2/user/find-many', {
      logins: ['[email protected]', '+9876543210']
    }, {
      headers: {
        'Seller-Id': '{{ sellerId }}',
        'School-Id': '{{ schoolId }}',
        'Content-Type': 'application/json',
        'Authorization': 'Bearer YOUR_TOKEN'
      }
    });

    console.log('Users found:', response.data.payload.users);
  } catch (error) {
    console.error('Error:', error.response?.data || error.message);
  }
};

findManyUsers();

import requests
import json

url = 'https://api.exode.biz/saas/v2/user/find-many'

data = {
  'logins': ['[email protected]', '+9876543210']
}

headers = {
  'Seller-Id': '{{ sellerId }}',
  'School-Id': '{{ schoolId }}',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}

response = requests.post(url, json=data, headers=headers)
response.raise_for_status()

result = response.json()
print(json.dumps(result['payload']['users'], indent=2, ensure_ascii=False))

{
  "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,
        "status": "Active",
        "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
          }
        }
      }
    ]
  }
}

{
  "success": true,
  "code": 201,
  "payload": {
    "users": []
  }
}

{
  "cause": "validation",
  "code": 400,
  "success": false,
  "error": "Bad Request",
  "message": [
    "logins should not be empty"
  ]
}

Permission requirements

Finding users requires the “School User Management” permission (SchoolManageUsers).

The service user must be authenticated with a token and have the appropriate access permissions for the specified school.

Updated: 2026-09-25 14:33 UTC

Working with the API

Users

Staff (HR)

Groups

Courses

Access and sales

Reports and exports

Custom fields

Forms

Missing a method?

All objects

Find by a list of identifiers

Request headers

Request parameters

Pass at least one of the identifier lists

Permission requirements

​Request headers

​Request parameters

Pass at least one of the identifier lists

​Permission requirements

Request headers

Request parameters

Permission requirements