метод REST scope: humanresources

humanresources.node.search

Найти отделы

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

Описание

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

Метод humanresources.node.search ищет отделы или команды по названию.

Параметры

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

Тип элемента структуры.

Возможные значения:

  • DEPARTMENT — отдел
  • TEAM — команда
name string обязательный

Строка поиска по части названия отдела или команды

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

Идентификатор родительского отдела для ограничения поиска.

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

pagination object необязательный

Параметр постраничной навигации.

Для метода используется limit — количество записей на страницу. По умолчанию 50, максимум 200

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"type":"DEPARTMENT","name":"Продажи","parentId":1,"pagination":{"limit":20}}' \
https://**put_your_bitrix24_address**/rest/api/**put_your_user_id_here**/**put_your_webhook_here**/humanresources.node.search

Ответ

HTTP-статус: 200

{
    "result": {
        "items": [
            {
                "id": 12,
                "name": "Продажи B2B",
                "type": "DEPARTMENT",
                "structureId": 1,
                "parentId": 1,
                "description": "Работа с корпоративными клиентами",
                "accessCode": "DR12",
                "userCount": 9,
                "colorName": null,
                "xmlId": null,
                "createdAt": "2026-05-20T10:15:00+03:00",
                "updatedAt": "2026-06-01T16:30:00+03:00"
            }
        ]
    },
    "time": {
        "start": 1780399800,
        "finish": 1780399800.314519,
        "duration": 0.31451892852783203,
        "processing": 0.2811400890350342,
        "date_start": "2026-06-02T14:30:00+03:00",
        "date_finish": "2026-06-02T14:30:00+03:00",
        "operating_reset_at": 1780400400,
        "operating": 0
    }
}

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

result object

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

items array

Массив найденных отделов и команд

items[] object

Объект найденного отдела или команды

id integer

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

name string

Название отдела

type string

Тип элемента структуры

structureId integer

Идентификатор структуры компании

parentId integer

Идентификатор родительского отдела

description string

Описание отдела

accessCode string

Код доступа отдела

userCount integer

Количество пользователей в отделе

colorName string

Цвет команды, если он задан

xmlId string

Внешний идентификатор отдела

createdAt datetime

Дата и время создания отдела

updatedAt datetime

Дата и время последнего обновления отдела

time time

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

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

HTTP-статус: 400

{
    "error": {
        "code": "BITRIX_REST_V3_EXCEPTION_VALIDATION_REQUESTVALIDATIONEXCEPTION",
        "message": "Ошибка при валидации объекта запроса",
        "validation": [
            {
                "message": "Обязательное поле `name` не указано",
                "field": "name"
            }
        ]
    }
}
Код Описание Значение
Поле Описание ошибки Как исправить
type name Обязательное поле #FIELD# не указано Добавьте указанное поле в тело запроса
FIELD# В поле #FIELD# требуется тип данных #TYPE# для такого запроса Убедитесь, что передаваемое значение нужного типа
type Передано недопустимое значение типа отдела Используйте DEPARTMENT для отдела или TEAM для команды

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

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