For AI agents: markdown of this page — /docs-content-en/entities/calendar-resources/bookings.md documentation index — /llms.txt

Resource bookings

GET /v1/calendar-resources/bookings · Bitrix24 API: calendar.resource.booking.list · Scope: calendar

Parameters

Parameter	Type	Required	Description
resourceIds	string	Yes	Comma-separated IDs from resource list; calendar resource section IDs, not CRM resource-booking entries.
from	ISO date	No	Range start. Default one month before today.
to	ISO date	No	Range end. Default three months after today; with only from, B24 uses its maximum date.

Examples

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/calendar-resources/bookings?resourceIds=7,49&from=2026-10-01&to=2026-11-01" -H "X-Api-Key: $VIBE_API_KEY"

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/calendar-resources/bookings?resourceIds=7,49&from=2026-10-01&to=2026-11-01" -H "X-Api-Key: $VIBE_API_KEY" -H "Authorization: Bearer $VIBE_USER_TOKEN"

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/calendar-resources/bookings?resourceIds=7,49&from=2026-10-01&to=2026-11-01', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey }
});
console.log(await response.json());

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/calendar-resources/bookings?resourceIds=7,49&from=2026-10-01&to=2026-11-01', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey , 'Authorization': `Bearer ${userToken}` }
});
console.log(await response.json());

Response

JSON

{
  "success": true,
  "data": [],
  "meta": {
    "total": 0
  }
}

Response fields

Field	Type	Description
success	boolean	True on success.
data	array	Intervals: id, name, resourceId, bookingId, from, to, timezoneFrom, timezoneTo, skipTime, accessibility, importance, eventType. Optional fields depend on B24; bookingId can be null. Dates are ISO-8601.
meta.total	integer	Returned interval count.

Errors

HTTP	Code	Condition
400	INVALID_PARAMS	Invalid IDs, dates or status.
400	MISSING_REQUIRED_FIELDS	Required values are absent.
401	TOKEN_MISSING	The key has no usable B24 credentials.
403	SCOPE_DENIED	calendar scope is missing.
403	WRITE_BLOCKED_READONLY_KEY	The key forbids a write.
403	BITRIX_ACCESS_DENIED	Bitrix24 denied access.
422	BITRIX_ERROR	B24 refused the operation or did not persist the write.
429	RATE_LIMITED	Request limit exceeded.
502	BITRIX_UNAVAILABLE	Invalid or unavailable B24 response.
503	BITRIX_TIMEOUT	B24 timed out.

Invalid input returns an error instead of an empty result: