#Текущий статус

GET /v1/workday/status

Возвращает текущее состояние рабочего дня сотрудника: статус, время начала и завершения, длительность, перерывы.

#Параметры

#Примеры

#curl — личный ключ

curl -H "X-Api-Key: YOUR_API_KEY" \
  https://vibecode.bitrix24.tech/v1/workday/status

#curl — статус другого сотрудника

curl -H "X-Api-Key: YOUR_API_KEY" \
  "https://vibecode.bitrix24.tech/v1/workday/status?userId=503"

#curl — OAuth-приложение

curl -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  https://vibecode.bitrix24.tech/v1/workday/status

#JavaScript — личный ключ

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/status', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()
console.log('Статус:', data.status)
console.log('Активный день:', data.active)
console.log('Длительность:', data.duration)

#JavaScript — статус другого сотрудника

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/status?userId=503', {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
})
const { data } = await res.json()

#JavaScript — OAuth-приложение

const res = await fetch('https://vibecode.bitrix24.tech/v1/workday/status', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const { data } = await res.json()

#Поля ответа

Когда у запрошенного сотрудника нет записи рабочего дня, в data присутствует только status — остальные поля отсутствуют. Подробнее — «Вырожденный ответ без записи дня» в «Известных особенностях».

#Возможные значения `status`

#Пример ответа

{
  "success": true,
  "data": {
    "status": "OPENED",
    "timeStart": "2026-05-05T09:00:00+03:00",
    "timeFinish": null,
    "duration": "04:00:00",
    "timeLeaks": "00:30:00",
    "active": true,
    "ipOpen": "203.0.113.10",
    "ipClose": "",
    "latOpen": 0,
    "lonOpen": 0,
    "latClose": 0,
    "lonClose": 0,
    "tzOffset": 10800
  }
}

Сотрудник без записи рабочего дня — ответ вырождается до одного поля status:

{
  "success": true,
  "data": {
    "status": "CLOSED"
  }
}

#Пример ответа при ошибке

403 — у ключа нет скоупа timeman:

{
  "success": false,
  "error": {
    "code": "SCOPE_DENIED",
    "message": "This endpoint requires 'timeman' scope"
  }
}

#Ошибки

Полный список общих ошибок API — Ошибки.

#Известные особенности

• Состояние после закрытия. После закрытия дня эндпоинт продолжает возвращать сведения последнего дня (CLOSED, заполненный timeFinish) до открытия следующего — отчёт по закрытому дню доступен этим же запросом.
• Запись может быть любой давности — сверяйте timeStart с сегодняшней датой. status и timeStart описывают последнюю запись рабочего дня сотрудника, а она может быть сколь угодно старой: Битрикс24 timeman.status возвращает последнюю запись независимо от её возраста. И день, CLOSED три года назад, и день, оставшийся EXPIRED (открытым и не закрытым) пять дней назад, отдаются как есть — ни один из них не означает «сегодня». У эндпоинта нет фильтра «только сегодня», поэтому, чтобы понять, относится ли день к текущей дате, сравните дату из timeStart с сегодняшней на своей стороне, прежде чем доверять status. Для командного дашборда считайте запись, у которой timeStart не сегодняшний, как «рабочий день сегодня не начат».
• Вырожденный ответ без записи дня. Если у запрошенного сотрудника нет записи рабочего дня, data содержит только поле status. Остальные поля (timeStart, timeFinish, duration и прочие) в ответе отсутствуют, поэтому проверяйте наличие поля перед чтением. Запись отсутствует, например, у сотрудника, которому день ни разу не открывали.
• Закрытие просроченного дня. В статусе EXPIRED день закрывается задним числом. Передайте в `POST /v1/workday/close` параметр time с датой, равной дате открытия дня — это значение timeStart из ответа этого эндпоинта — вместе с обязательным report. Дата time, не равная дате открытия, возвращает 422.

#Смотрите также

• Открыть рабочий день — POST /v1/workday/open.
• Закрыть рабочий день — POST /v1/workday/close.
• Поставить на паузу — POST /v1/workday/pause.
• Настройки учёта — GET /v1/workday/settings.
• Рабочий день — обзор раздела.