Lists company bookings

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

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://connect.deskbird.com/bookings?offset&limit&startDate&endDate&updatedAt=2024-01-01T23:00:00.000Z..2025-02-01T05:15:00.000Z&ids&statuses&userIds&zoneIds&resourceIds&officeIds' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK

application/json

List of bookings matching the provided filters

Body

Example

{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "userId": "123e4567-e89b-12d3-a456-426614174000",
            "anonymized": false,
            "autoCancellationTime": "2021-01-01T00:00:00.000Z",
            "checkInStatus": "checkedIn",
            "earlyReleaseEndTime": "2021-01-01T00:00:00.000Z",
            "endTime": "2021-01-01T00:00:00.000Z",
            "guest": {
                "firstName": "John",
                "lastName": "Doe",
                "email": "john.doe@example.com"
            },
            "isAnonymousBooking": false,
            "startTime": "2021-01-01T00:00:00.000Z",
            "status": "accepted",
            "zoneId": "1234",
            "floorId": "1122",
            "resourceId": "123e4567-e89b-12d3-a456-426614174000",
            "resource": {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "name": "Desk 1",
                "type": "flexDesk"
            },
            "officeId": "ca99dd78-2efb-49eb-a254-be0e3d56ca15",
            "user": {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "email": "john.doe@example.com",
                "firstName": "John",
                "lastName": "Doe"
            },
            "cancelledBy": "auto",
            "cancelledByUserId": "123e4567-e89b-12d3-a456-426614174000",
            "history": [
                {
                    "action": "created",
                    "source": "deskbird-api",
                    "userUuid": "123e4567-e89b-12d3-a456-426614174000",
                    "completedAt": "2021-01-01T00:00:00.000Z"
                }
            ],
            "createdAt": "2021-01-01T00:00:00.000Z",
            "updatedAt": "2021-01-01T00:00:00.000Z"
        }
    ]
}

🟠401Unauthorized

🟠403Forbidden