Lists company tickets

Retrieves a paginated list of the company's workplace tickets, newest first. Filter by office, status, category, assignee and urgency. To poll for changes pass updatedAt, the range the other endpoints use: the list is then ordered by updatedAt ascending, and every edit moves a ticket's updatedAt, so repeat the newest updatedAt you have seen and de-duplicate by id. Canceled tickets are returned like any other status. Each ticket carries its category name, custom field labels and the metadata of its attached files, so it can be read without a second call. File contents are not served by this API.

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

Tickets matching the filters, one page

Bodyapplication/json

Example

{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "id": "11eebc99-9c0b-4ef8-bb6d-6bb9bd380101",
            "code": "FAC-1042",
            "status": "open",
            "urgency": "low",
            "source": "web",
            "officeId": "a1eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
            "floorId": "31eebc99-9c0b-4ef8-bb6d-6bb9bd380301",
            "zoneId": "41eebc99-9c0b-4ef8-bb6d-6bb9bd380401",
            "resourceId": null,
            "locationInfo": "Kitchen, second floor",
            "category": {
                "id": "51eebc99-9c0b-4ef8-bb6d-6bb9bd380501",
                "name": "Facilities"
            },
            "reportedById": "61eebc99-9c0b-4ef8-bb6d-6bb9bd380601",
            "reportedBy": {
                "id": "d1eebc99-9c0b-4ef8-bb6d-6bb9bd380d01",
                "email": "john.doe@deskbird.com",
                "firstName": "John",
                "lastName": "Doe"
            },
            "assignedToId": null,
            "assignedTo": {
                "id": "d1eebc99-9c0b-4ef8-bb6d-6bb9bd380d01",
                "email": "john.doe@deskbird.com",
                "firstName": "John",
                "lastName": "Doe"
            },
            "customFields": [
                {
                    "id": "a2eebc99-9c0b-4ef8-bb6d-6bb9bd380a02",
                    "label": "What is affected?",
                    "type": "shortText",
                    "value": "string"
                }
            ],
            "attachments": [
                {
                    "id": "91eebc99-9c0b-4ef8-bb6d-6bb9bd380901",
                    "fileName": "broken-machine.jpg",
                    "mimeType": "image/jpeg"
                }
            ],
            "createdAt": "2026-06-01T08:00:00.000Z",
            "updatedAt": "2026-06-02T09:15:00.000Z"
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden