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

List calendar resources

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

Parameters

Parameter	Type	Required	Description
limit	integer	No	Maximum records, default 50.
offset	integer	No	Records to skip; the full B24 list is windowed locally.

Examples

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/calendar-resources" -H "X-Api-Key: $VIBE_API_KEY"

Terminal

curl -X GET "https://vibecode.bitrix24.com/v1/calendar-resources" -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', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey }
});
console.log(await response.json());

javascript

const response = await fetch('https://vibecode.bitrix24.com/v1/calendar-resources', {
  method: 'GET',
  headers: { 'X-Api-Key': apiKey , 'Authorization': `Bearer ${userToken}` }
});
console.log(await response.json());

Response

JSON

{
  "success": true,
  "data": [
    {
      "id": 7,
      "name": "Meeting room",
      "createdBy": 1
    }
  ],
  "meta": {
    "total": 1
  }
}

Response fields

Field	Type	Description
success	boolean	True on success.
data	array	Resources: id, name, createdBy.
meta.total	integer	Resource 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: