Attendee availability

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

Parameters

Parameter	Type	Required	Description
ParameteruserIds	Typestring	RequiredYes	DescriptionComma-separated employee IDs from users.
Parameterfrom	TypeISO date	RequiredYes	DescriptionRange start.
Parameterto	TypeISO date	RequiredYes	DescriptionRange end.

Examples

Terminal

curl -X GET "https://vibecode.bitrix24.com/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.com/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.com/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.com/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());

Response

JSON

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

Response fields

Field	Type	Description
Fieldsuccess	Typeboolean	DescriptionTrue on success.
Fielddata	Typeobject	DescriptionEmployee ID keys, each with an array of busy intervals. Intervals expose id, name, from, to, timezoneFrom, timezoneTo, skipTime, accessibility, importance, eventType and fromHr where present. Dates are ISO-8601; B24 masks private titles. Empty array means no visible busy intervals.

Errors

HTTP	Code	Condition
HTTP400	CodeINVALID_PARAMS	ConditionInvalid IDs, dates or status.
HTTP400	CodeMISSING_REQUIRED_FIELDS	ConditionRequired values are absent.
HTTP401	CodeTOKEN_MISSING	ConditionThe key has no usable B24 credentials.
HTTP403	CodeSCOPE_DENIED	Conditioncalendar scope is missing.
HTTP403	CodeWRITE_BLOCKED_READONLY_KEY	ConditionThe key forbids a write.
HTTP403	CodeBITRIX_ACCESS_DENIED	ConditionBitrix24 denied access.
HTTP422	CodeBITRIX_ERROR	ConditionB24 refused the operation or did not persist the write.
HTTP429	CodeRATE_LIMITED	ConditionRequest limit exceeded.
HTTP502	CodeBITRIX_UNAVAILABLE	ConditionInvalid or unavailable B24 response.
HTTP503	CodeBITRIX_TIMEOUT	ConditionB24 timed out.

Invalid input returns an error instead of an empty result: