метод REST scope: im

im.user.get

Получить данные о пользователе

Кто может выполнять: любой пользователь

Описание

Метод im.user.get получает данные о текущем пользователе или о пользователе по ID.

Параметры

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

Идентификатор пользователя. Если не передан, метод вернет данные текущего пользователя.

Получить идентификатор пользователя можно методами user.get, user.search или im.chat.user.list

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

Параметр для запроса поля avatar_hr с адресом аватара в высоком разрешении. Допустимые значения: Y или N, по умолчанию N.

На текущий момент поле avatar_hr возвращается всегда, независимо от значения параметра

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"ID":5,"AVATAR_HR":"Y"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.user.get

Ответ

HTTP-статус: 200

{
    "result": {
        "id": 5,
        "active": true,
        "name": "Иван Петров",
        "first_name": "Иван",
        "last_name": "Петров",
        "work_position": "Менеджер",
        "color": "#048bd0",
        "avatar": "https://example.bitrix24.ru/upload/main/avatar.png",
        "avatar_hr": "https://example.bitrix24.ru/upload/main/avatar_hr.png",
        "gender": "M",
        "birthday": "",
        "extranet": false,
        "network": false,
        "bot": false,
        "connector": false,
        "external_auth_id": "default",
        "status": "online",
        "idle": false,
        "last_activity_date": "2026-03-02T09:30:00+03:00",
        "mobile_last_date": false,
        "desktop_last_date": false,
        "absent": false,
        "departments": [10],
        "phones": {
            "work_phone": "+71234567890",
            "personal_mobile": "+71234567890",
            "inner_phone": "21"
        },
        "website": "example.ru",
        "email": "user@example.ru",
        "bot_data": null,
        "type": "user"
    },
    "time": {
        "start": 1760000000.0,
        "finish": 1760000000.2,
        "duration": 0.2,
        "processing": 0.08,
        "date_start": "2026-03-02T09:30:00+03:00",
        "date_finish": "2026-03-02T09:30:00+03:00",
        "operating_reset_at": 1760030000,
        "operating": 0
    }
}

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

result object

Объект с данными пользователя.

Структура объекта подробно описана ниже

time time

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

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

HTTP-статус: 400

{
    "error": "ID_EMPTY",
    "error_description": "User ID can't be empty"
}
Код Описание Значение
ID_EMPTY User ID can't be empty Передан ID <= 0
USER_NOT_EXISTS User is not exists Пользователь с указанным ID не найден
ACCESS_DENIED You can request only users who consist of your extranet group Текущий экстранет-пользователь запрашивает пользователя не из своей экстранет-группы

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

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