Для AI-агентов: markdown этой страницы — /docs-content/calendar/accessibility.md индекс документации — /llms.txt

Занятость сотрудников

GET /v1/calendar/accessibility · Bitrix24 API: calendar.accessibility.get · Scope: calendar

Параметры

Параметр	Тип	Обязателен	Описание
userIds	string	Да	ID сотрудников из списка пользователей через запятую.
from	ISO date	Да	Начало периода.
to	ISO date	Да	Конец периода.

Примеры

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/calendar/accessibility?userIds=1373&from=2026-10-02&to=2026-10-03" -H "X-Api-Key: $VIBE_API_KEY"

Terminal

curl -X GET "https://vibecode.bitrix24.tech/v1/calendar/accessibility?userIds=1373&from=2026-10-02&to=2026-10-03" -H "X-Api-Key: $VIBE_API_KEY" -H "Authorization: Bearer $VIBE_USER_TOKEN"

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/calendar/accessibility?userIds=1373&from=2026-10-02&to=2026-10-03', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey }
});
console.log(await response.json());

javascript

const response = await fetch('https://vibecode.bitrix24.tech/v1/calendar/accessibility?userIds=1373&from=2026-10-02&to=2026-10-03', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey , 'Authorization': `Bearer ${userToken}` }
});
console.log(await response.json());

Ответ

JSON

{
  "success": true,
  "data": {
    "1373": []
  }
}

Поля ответа

Поле	Тип	Описание
success	boolean	Признак успешного запроса.
data	object	Ключи — ID сотрудников, значения — массивы занятых интервалов. Поля: id, name, from, to, timezoneFrom, timezoneTo, skipTime, accessibility, importance, eventType и fromHr при наличии. Даты в ISO-8601; приватные названия скрывает Б24. Пустой массив означает отсутствие видимых занятых интервалов.

Ошибки

HTTP	Code	Причина
400	INVALID_PARAMS	Неверные ID, даты или статус.
400	MISSING_REQUIRED_FIELDS	Не переданы обязательные значения.
401	TOKEN_MISSING	У ключа нет доступных учётных данных Б24.
403	SCOPE_DENIED	У ключа нет скоупа calendar.
403	WRITE_BLOCKED_READONLY_KEY	Ключ запрещает запись.
403	BITRIX_ACCESS_DENIED	Б24 запретил доступ.
422	BITRIX_ERROR	Б24 отклонил операцию или не сохранил изменение.
429	RATE_LIMITED	Превышен лимит запросов.
502	BITRIX_UNAVAILABLE	Ответ Б24 недоступен или имеет неверную форму.
503	BITRIX_TIMEOUT	Б24 не ответил вовремя.

Неверный запрос возвращает ошибку, а не пустой результат:

JSON

{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid calendar parameters"}}

Все ошибки

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

При skipTime=true from/to — календарные даты ISO-8601 без зоны; to включает последний день. Часовой пояс Б24 для таких событий отсутствует. Для остальных интервалов from/to — ISO datetime со смещением.