Public API
  1. Rooms
Public API
  • Welcome to the deskbird Public API
  • Users
    • Lists company users
      GET
    • Lists single company user
      GET
  • Bookings
    • Lists company bookings
      GET
    • Creates booking
      POST
    • Lists single company booking
      GET
    • Updates booking
      PATCH
    • Cancels booking
      PATCH
    • Check in to the booking
      PATCH
    • Early release the booking
      PATCH
  • Groups
    • Lists company user groups
      GET
    • Lists single company user group
      GET
  • Resources
    • Get a resource by id
      GET
    • Lists company resources
      GET
  • Offices
    • Lists company offices
      GET
    • Check User into Office
      POST
  • Scheduling
    • Lists company scheduling
    • Delete scheduling statuses by IDs
    • Add new scheduling statuses for a user
  • Scheduling Options
    • Lists company scheduling options
  • Rooms
    • Lists company rooms
      GET
    • Gets single room
      GET
    • Lists room bookings
      GET
    • Create a room booking
      POST
    • Gets single room booking
      GET
    • Update a room booking
      PATCH
    • Check in to a room booking
      PATCH
    • Cancel a room booking
      PATCH
  1. Rooms

Lists room bookings

GET
/rooms/{roomId}/bookings
Returns bookings for a specific room within a provided timeframe

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://connect.deskbird.com/rooms//bookings?offset&limit&userIds&startTime&endTime' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
List of room bookings retrieved successfully
Body

Example
{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "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",
            "title": "Team Meeting",
            "type": "occurrence",
            "userId": "user-123"
        }
    ]
}
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
Previous
Gets single room
Next
Create a room booking
Built with