Получить информацию о текущем пользователе user.current

Выберите инструмент для разработки с AI-агентом:

используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: user, user_brief, user_basic

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

Метод user.current возвращает профиль пользователя, чей токен использован в запросе: для сохраненного токена администратора это администратор, для токена из фрейма приложения — пользователь, который открыл приложение.

Перечень полей пользователей Битрикс24, который будет получен в результате выполнения метода, зависит от скоупа приложения/вебхука. Какие поля доступны в каждой версии — в статье Версии скоупа user.

Параметры метода

Без параметров.

Чтобы узнать, какой пользователь открыл приложение во фрейме Битрикс24, вызовите метод с токеном AUTH_ID из запроса к приложению на домен DOMAIN.

Примеры кода

Как использовать примеры в документации

cURL (Webhook)

cURL (OAuth)

JS (TS)

JS (UMD)

Python

PHP

BX24.js

PHP CRest

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/user.current

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/user.current

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

// Shape of the payload returned in result (match the "response handling" section of the page)
type UserCurrentResult = {
  ID: string
  ACTIVE: boolean
  NAME: string
  LAST_NAME: string
  EMAIL: string
  LAST_LOGIN: ISODate | ''
  DATE_REGISTER: ISODate | ''
  IS_ONLINE: string
  LAST_ACTIVITY_DATE?: string
  PERSONAL_GENDER: string
  PERSONAL_BIRTHDAY: string
  WORK_POSITION: string
  UF_EMPLOYMENT_DATE: string
  UF_DEPARTMENT: number[]
}

try {
  const response = await $b24.actions.v2.call.make<UserCurrentResult>({
    method: 'user.current',
    params: {},
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info('Current user:', result.ID, result.NAME, result.LAST_NAME)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function getCurrentUser() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'user.current',
        params: {},
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info('Current user:', result.ID, result.NAME, result.LAST_NAME)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', getCurrentUser)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.user.current().response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")

try {
    $response = $b24Service
        ->core
        ->call(
            'user.current',
            []
        );

    $result = $response
        ->getResponseData()
        ->getResult();

    print_r($result);
} catch (Throwable $e) {
    echo $e->getMessage();
}

BX24.callMethod(
    "user.current",
    {},
    function(result)
    {
        if(result.error())
            console.error(result.error());
        else
            console.dir(result.data());
    }
);

require_once('crest.php');

$result = CRest::call(
    'user.current',
    []
);

echo '<PRE>';
print_r($result);
echo '</PRE>';

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "user.current", nil)
if err != nil {
	return fmt.Errorf("user.current: %w", err)
}

var item struct {
	ID        b24.ID `json:"ID"`
	Active    bool   `json:"ACTIVE"`
	Name      string `json:"NAME"`
	LastName  string `json:"LAST_NAME"`
	Email     string `json:"EMAIL"`
	LastLogin string `json:"LAST_LOGIN"`
}
if err := json.Unmarshal(res.Result, &item); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println(item.ID, item.Active)

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "ID": "1",
        "XML_ID": "10001",
        "ACTIVE": true,
        "NAME": "Иван",
        "LAST_NAME": "Иванов",
        "EMAIL": "ivanov@example.com",
        "LAST_LOGIN": "2026-10-29T15:13:52+03:00",
        "DATE_REGISTER": "2025-10-02T03:00:00+03:00",
        "TIME_ZONE": "Europe/Moscow",
        "IS_ONLINE": "Y",
        "TIMESTAMP_X": "10/27/2026 12:12:19 pm",
        "LAST_ACTIVITY_DATE": "2026-10-29 17:58:08",
        "PERSONAL_GENDER": "M",
        "PERSONAL_BIRTHDAY": "",
        "PERSONAL_PHOTO": "https://cdn-ru.bitrix24.ru/b1/main/a1b/a1b2c3/avatar.png",
        "PERSONAL_MOBILE": "+79990000000",
        "WORK_POSITION": "Менеджер по продажам",
        "UF_EMPLOYMENT_DATE": "",
        "UF_DEPARTMENT": [
            1
        ],
        "UF_USR_USER_DEALS": false
    },
    "time": {
        "start": 1793286068,
        "finish": 1793286068.341957,
        "duration": 0.34195709228515625,
        "processing": 0,
        "date_start": "2026-10-29T18:01:08+03:00",
        "date_finish": "2026-10-29T18:01:08+03:00",
        "operating_reset_at": 1793286660,
        "operating": 0
    }
}

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

Название `тип`	Описание
result `object`	Профиль пользователя (подробное описание)
time `time`	Информация о времени выполнения запроса

Поля пользователя

Метод возвращает только поля, разрешенные версией скоупа, — список по версиям в статье Версии скоупа user. Поле со значением null в ответ не попадает, пустые строки возвращаются.

Название `тип`	Описание
ID `string`	Идентификатор пользователя. Число в виде строки
XML_ID `string`	Внешний код пользователя
ACTIVE `boolean`	Активен ли пользователь: `true` — работает `false` — уволен
NAME `string`	Имя
LAST_NAME `string`	Фамилия
SECOND_NAME `string`	Отчество
TITLE `string`	Обращение
EMAIL `string`	E-mail
LAST_LOGIN `string`	Дата и время последней авторизации в формате ISO 8601, например `2026-10-29T15:13:52+03:00`
DATE_REGISTER `string`	Дата регистрации в формате ISO 8601
TIME_ZONE `string`	Часовой пояс пользователя, например `Europe/Moscow`
IS_ONLINE `string`	Пользователь в сети: `Y` — в сети `N` — не в сети
TIMESTAMP_X `string`	Дата и время последнего изменения профиля в формате сайта, например `10/27/2026 12:12:19 pm`
LAST_ACTIVITY_DATE `string`	Дата и время последней активности в формате `ГГГГ-ММ-ДД ЧЧ:ММ:СС`
PERSONAL_GENDER `string`	Пол: `M` — мужской `F` — женский пустая строка — не указан
PERSONAL_PROFESSION `string`	Профессия
PERSONAL_WWW `string`	Личный сайт
PERSONAL_BIRTHDAY `string`	Дата рождения в формате ISO 8601. Пустая строка, если не указана
PERSONAL_PHOTO `string`	Ссылка на фотографию профиля
PERSONAL_ICQ `string`	ICQ
PERSONAL_PHONE `string`	Личный телефон
PERSONAL_FAX `string`	Личный факс
PERSONAL_MOBILE `string`	Личный мобильный телефон
PERSONAL_PAGER `string`	Пейджер
PERSONAL_STREET `string`	Улица проживания
PERSONAL_CITY `string`	Город проживания
PERSONAL_STATE `string`	Область или край проживания
PERSONAL_ZIP `string`	Почтовый индекс проживания
PERSONAL_COUNTRY `string`	Код страны проживания. `0`, если страна не указана
PERSONAL_MAILBOX `string`	Почтовый ящик
PERSONAL_NOTES `string`	Дополнительные заметки
WORK_PHONE `string`	Рабочий телефон
WORK_COMPANY `string`	Компания
WORK_POSITION `string`	Должность
WORK_DEPARTMENT `string`	Отдел — текстовое поле. Подразделения из структуры компании хранятся в `UF_DEPARTMENT`
WORK_WWW `string`	Сайт компании
WORK_FAX `string`	Рабочий факс
WORK_PAGER `string`	Рабочий пейджер
WORK_STREET `string`	Улица места работы
WORK_MAILBOX `string`	Рабочий почтовый ящик
WORK_CITY `string`	Город места работы
WORK_STATE `string`	Область или край места работы
WORK_ZIP `string`	Почтовый индекс места работы
WORK_COUNTRY `string`	Код страны места работы. `0`, если страна не указана
WORK_PROFILE `string`	Направление деятельности компании
WORK_LOGO `string`	Логотип компании
WORK_NOTES `string`	Заметки о месте работы
UF_SKYPE_LINK `string`	Ссылка на чат в Skype
UF_ZOOM `string`	Zoom
UF_EMPLOYMENT_DATE `string`	Дата приема на работу в формате ISO 8601. Пустая строка, если не указана
UF_TIMEMAN `string`	Включен ли учет рабочего времени для пользователя: `1` — включен, другое значение — выключен
UF_DEPARTMENT `integer[]`	Идентификаторы подразделений из структуры компании. Получить подразделения можно методом department.get
UF_INTERESTS `string`	Интересы
UF_SKILLS `string`	Навыки
UF_WEB_SITES `string`	Другие сайты
UF_XING `string`	Xing
UF_LINKEDIN `string`	LinkedIn
UF_FACEBOOK `string`	Facebook*
UF_TWITTER `string`	Twitter
UF_SKYPE `string`	Microsoft Teams. Код поля сохранился от Skype
UF_DISTRICT `string`	Район
UF_PHONE_INNER `string`	Внутренний телефон
USER_TYPE `string`	Тип пользователя. Основные значения: `employee` — сотрудник `extranet` — внешний пользователь экстранета `email` — пользователь, который пишет из почты `bot` — чат-бот
UF_USR_* `разные`	Пользовательские поля профиля. Тип значения зависит от типа поля: строка, число, массив или для файла объект с ключами `id`, `showUrl` и `downloadData`. Поля создают методы user.userfield.*

Поле USER_TYPE возвращают методы user.get и user.search. Метод user.current это поле не возвращает.

*Принадлежит компании Meta Platforms, Inc., которая признана экстремистской и запрещена на территории Российской Федерации.

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

HTTP-статус: 401

{
    "error": "INVALID_CREDENTIALS",
    "error_description": "Invalid request credentials"
}

Название `тип`	Описание
error `string`	Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только `error_description`
error_description `string`	Текст ошибки для разработчика. Не показывайте его конечному пользователю без обработки

Возможные коды ошибок

У метода нет параметров, поэтому собственных ошибок у него нет. Метод возвращает только системные ошибки, например:

Статус	Код	Описание	Значение
`401`	`INVALID_CREDENTIALS`	Invalid request credentials	Неверный код вебхука или токен авторизации
`401`	`insufficient_scope`	The request requires higher privileges than provided by the webhook token	У вебхука или приложения нет ни одной версии скоупа: `user`, `user_basic` или `user_brief`

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит
`401`	`NO_AUTH_FOUND` Wrong authorization data	В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука
`401`	`INVALID_REQUEST` Https required	Методы вызываются только по протоколу HTTPS
`401`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24
`401`	`ACCESS_DENIED` REST is available only on commercial plans	REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — `REST is available only by subscription`
`401`	`INVALID_CREDENTIALS` Invalid request credentials	Не найден активный вебхук с указанным идентификатором пользователя и секретным кодом
`404`	`ERROR_METHOD_NOT_FOUND` Method not found!	Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа
`401`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на `provided by the access token`
`401`	`expired_token` The access token provided has expired	Срок действия access-токена истек
`401`	`user_access_error` The user does not have access to the application	Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям
`403`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

Продолжите изучение

Была ли статья полезна?

Обновить данные пользователя

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

Получить информацию о текущем пользователе user.current

Параметры методаПараметры метода

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

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

Поля пользователяПоля пользователя

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

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

Продолжите изучениеПродолжите изучение