метод REST scope: humanresources

humanresources.node.get

Получить отдел

Кто может выполнять: пользователь с правом «Просмотр отделов» или «Просмотр команд»

Описание

Метод относится к REST 3.0. Особенности вызова и формат ответа новой версии API описаны в обзоре REST 3.0.

Метод humanresources.node.get возвращает отдел или команду по идентификатору.

Параметры

id integer обязательный

Идентификатор отдела или команды.

Идентификатор можно получить методом humanresources.node.list

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

Список полей отдела, которые нужно вернуть.

Доступные поля:

  • id — идентификатор отдела
  • name — название отдела
  • type — тип элемента структуры
  • structureId — идентификатор структуры компании
  • parentId — идентификатор родительского отдела
  • description — описание отдела
  • accessCode — код доступа отдела
  • userCount — количество пользователей в отделе
  • colorName — цвет команды
  • xmlId — внешний идентификатор отдела
  • createdAt — дата и время создания
  • updatedAt — дата и время последнего обновления
  • members — список пользователей отдела

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1,"select":["id","name","type","structureId","parentId","description","accessCode","userCount","colorName","xmlId","createdAt","updatedAt","members"]}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.get

Ответ

HTTP-статус: 200

{
    "result": {
        "item": {
            "id": 1,
            "name": "Отдел продаж",
            "type": "DEPARTMENT",
            "structureId": 1,
            "parentId": null,
            "description": "Основной отдел продаж",
            "accessCode": "DR1",
            "userCount": 18,
            "colorName": null,
            "xmlId": null,
            "createdAt": "2026-05-20T10:15:00+03:00",
            "updatedAt": "2026-06-02T10:30:00+03:00",
            "members": [
                {
                    "userId": 7,
                    "name": "Анна Смирнова",
                    "workPosition": "Руководитель отдела продаж",
                    "role": "MEMBER_HEAD",
                    "avatar": "https://example.bitrix24.ru/upload/main/1/avatar.jpg",
                    "url": "/company/personal/user/7/"
                }
            ]
        }
    },
    "time": {
        "start": 1780403400,
        "finish": 1780403400.213411,
        "duration": 0.2134110927581787,
        "processing": 0.1820049285888672,
        "date_start": "2026-06-02T15:30:00+03:00",
        "date_finish": "2026-06-02T15:30:00+03:00",
        "operating_reset_at": 1780404000,
        "operating": 0
    }
}

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

result object

Объект с данными ответа

item object

Объект с данными отдела или команды. Структура ответа зависит от select

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_ENTITYNOTFOUNDEXCEPTION",
        "message": "Запись с ID = `1` не найдена"
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
id Обязательное поле id не указано Добавьте id в тело запроса

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

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