Lists company bookings

Retrieves a paginated list of resource bookings for the company. Returns desk bookings, parking bookings, and other resource type bookings (excludes meeting room bookings). Supports filtering by date ranges (startDate, endDate, updatedAt), booking IDs, office IDs, resource IDs, user IDs, zone IDs, and booking statuses. Returns bookings with full details including user information, resource details, check-in status, and booking history.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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