метод REST scope: im

im.department.employees.get

Получить список сотрудников подразделений

Кто может выполнять: любой интранет-пользователь, кроме ботов

Описание

Метод im.department.employees.get получает список сотрудников указанных подразделений.

Параметры

ID array обязательный

Массив идентификаторов подразделений. Можно передать строку с JSON-массивом идентификаторов.

Получить идентификатор подразделения можно методом получения списка подразделений или методом поиска подразделений по названию

USER_DATA string необязательный

Возвращать подробные данные пользователей.

Возможные значения:
- Y — да
- N — нет

По умолчанию: N

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"ID":[3,7],"USER_DATA":"Y"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.department.employees.get

Ответ

HTTP-статус: 200

{
    "result": {
        "7": [3,67,61,103],
        "3": [278,517,13]
    },
    "time": {
        "start": 1772519829,
        "finish": 1772519829.456118,
        "duration": 0.456118106842041,
        "processing": 0,
        "date_start": "2026-03-03T09:37:09+03:00",
        "date_finish": "2026-03-03T09:37:09+03:00",
        "operating_reset_at": 1772520429,
        "operating": 0.18364310264587402
    }
}

Возвращаемые данные

result object

Корневой объект, где ключ — идентификатор подразделения, значение:
- при USER_DATA = 'N' содержит массив идентификаторов сотрудников,
- при USER_DATA = 'Y' содержит массив объектов с описанием пользователей (подробное описание)

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "ID_EMPTY",
    "error_description": "Department ID can't be empty"
}
Код Описание Значение
400 ID_EMPTY Department ID can't be empty
403 ACCESS_ERROR Only intranet users have access to this method

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.