Lists company room bookings

GET

/rooms/bookings

Retrieves room bookings across the company for synchronization and reconciliation. Supports office, room, user, status, time, creation-time, and update-time filters. Cancelled bookings are included automatically for updatedAt delta queries.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://connect.deskbird.com/rooms/bookings?offset=undefined&limit=undefined&userIds=undefined&startTime=undefined&endTime=undefined&officeIds=undefined&roomIds=undefined&statuses=undefined&createdAt=undefined&updatedAt=undefined' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

List of room bookings retrieved successfully

Bodyapplication/json

Example

{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "createdAt": "2024-01-01T09:00:00.000Z",
            "attendees": [
                {
                    "email": "john.doe@example.com"
                }
            ],
            "durationInSeconds": 3600,
            "id": "booking-123",
            "isCheckedIn": false,
            "isPrivate": false,
            "officeId": "office-123",
            "roomId": "room-123",
            "startTime": "2024-01-01T10:00:00Z",
            "status": "accepted",
            "title": "Team Meeting",
            "type": "occurrence",
            "userId": "user-123",
            "updatedAt": "2024-01-01T09:30:00.000Z"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden

Cancels a room booking

Lists company floors