1. Service requests
Public API
  • Welcome to the deskbird developer docs
  • Public API
    • Overview
    • Users
      • Lists company users
      • Retrieves a single company user
    • Bookings
      • Lists company bookings
      • Creates a new resource booking
      • Gets a single company booking
      • Updates an existing booking
      • Cancels a booking
      • Checks in to a booking
      • Releases a booking early
    • Groups
      • Lists company user groups
      • Retrieves a single company user group
    • Resources
      • Gets a resource by ID
      • Lists company resources
    • Offices
      • Lists company offices
      • Checks a user into an office
    • Scheduling
      • Lists company scheduling statuses
      • Deletes scheduling statuses by IDs
      • Adds new scheduling statuses for a user
    • Scheduling Options
      • Lists company scheduling options
    • Rooms
      • Lists company rooms
      • Gets a single room
      • Creates a room booking
      • Lists room bookings
      • Gets a single room booking
      • Updates a room booking
      • Checks in to a room booking
      • Cancels a room booking
      • Lists company room bookings
    • Floors
      • Lists company floors
    • Zones
      • Lists company zones
    • Tickets
      • Updates a ticket
    • Sensors
      • Lists company monitors
  • MCP server
    • Overview
    • Authentication
    • Tools reference
  • Sensors
    • Lists company network configurations
  • Visitors
    • Lists company visit types
    • Lists company visits
    • Gets a single company visit
  • Tickets
    • Lists company tickets
    • Gets a single company ticket
    • Lists ticket categories
  • Service requests
    • Lists company service requests
      GET
    • Lists service categories of an office
      GET
    • Gets a single company service request
      GET
  • Schemas
    • Provider
    • UserStatus
    • UserIncludeOptions
    • BookingStatus
    • GuestEmbeddedResponse
    • UserEmbeddedResponse
    • ResourceEmbeddedResponse
    • BookingHistoryResponse
    • BookingResponse
    • PaginatedBookingResponse
    • CreateBookingGuestDto
    • CreateBookingDto
    • UpdateBookingDto
    • CheckInDto
    • AddressResponse
    • OpeningHourResponse
    • OpeningHoursResponse
    • OfficeResponse
    • EnvelopedOfficeResponse
    • CheckUserIntoOfficeBody
    • SharedResourceAccessInfoResponse
    • DedicatedResourceAccessInfoResponse
    • EquipmentResponse
    • ResourceResponse
    • ResourceType
    • PaginatedResourceResponse
    • SchedulingOutput
    • UserStatusInput
    • AddUserStatusesInput
    • SchedulingOptionOutput
    • AttendeeResponse
    • RoomBookingResponse
    • PaginatedRoomBookingResponse
    • RoomBookingDetailedResponse
    • AttendeeDto
    • RoomResponse
    • PaginatedRoomResponse
    • CreateRoomBookingDto
    • UpdateRoomBookingDto
    • FloorResponse
    • PaginatedFloorResponse
    • AssignedGroupResponse
    • ZoneResponse
    • PaginatedZoneResponse
    • UpdateTicketDto
    • MonitorState
    • MonitorOfficeResponse
    • MonitorFloorResponse
    • MonitorAreaResponse
    • MonitorDeskResponse
    • MonitorMappingResponse
    • MonitorResponse
    • PaginatedMonitorResponse
    • NetworkConflictSignal
    • NetworkConflictResponse
    • NetworkResponse
    • PaginatedNetworkResponse
    • TicketCategoryReferenceResponse
    • VisitTypeResponse
    • TicketUserResponse
    • EnvelopedVisitTypeResponse
    • TicketCustomFieldResponse
    • TicketAttachmentResponse
    • TicketResponse
    • PaginatedTicketResponse
    • TicketCommentResponse
    • TicketDetailsResponse
    • TicketCategoryCustomFieldResponse
    • TicketCategoryResponse
    • EnvelopedTicketCategoryResponse
    • RequestedItemResponse
    • RequestedCategoryResponse
    • VisitTypeReferenceResponse
    • ServiceRequestResponse
    • VisitHostResponse
    • PaginatedServiceRequestResponse
    • VisitorResponse
    • ServiceItemResponse
    • VisitResponse
    • ServiceCategoryResponse
    • PaginatedVisitResponse
    • EnvelopedServiceCategoryResponse
  1. Service requests

Lists company service requests

GET
/serviceRequests
Retrieves a paginated list of the company's service requests with their categories, items, quantities and cost centers. Results are sorted by startTime. Filter by office or by when the service is needed. startDate is inclusive and endDate is exclusive, so back-to-back windows never return the same request twice. To poll for changes, pass updatedAt. Results are then sorted by updatedAt. Use the newest updatedAt you have seen as the start of the next range, and de-duplicate by id. Deleted service requests no longer appear in results. Prices, totals and currency are not included. Requires the Catering & services module.

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
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://connect.deskbird.com/serviceRequests?limit=undefined&offset=undefined&updatedAt=undefined&endDate=undefined&startDate=undefined&officeId=undefined' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Service requests matching the filters, one page
Bodyapplication/json

Example
{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "id": "b1eebc99-9c0b-4ef8-bb6d-6bb9bd381101",
            "officeId": "a1eebc99-9c0b-4ef8-bb6d-6bb9bd380a11",
            "roomId": "e1eebc99-9c0b-4ef8-bb6d-6bb9bd381401",
            "location": "Board room",
            "requestedByUserId": "61eebc99-9c0b-4ef8-bb6d-6bb9bd380601",
            "startTime": "2026-06-24T09:00:00.000Z",
            "endTime": "2026-06-24T10:00:00.000Z",
            "categories": [
                {
                    "categoryId": "c1eebc99-9c0b-4ef8-bb6d-6bb9bd381201",
                    "title": "Catering",
                    "notes": "No nuts",
                    "costCenterCode": "CC-4711",
                    "items": [
                        {
                            "id": "d1eebc99-9c0b-4ef8-bb6d-6bb9bd381301",
                            "title": "Coffee",
                            "type": "quantity",
                            "quantity": 8,
                            "text": null,
                            "selectionType": "single",
                            "options": []
                        }
                    ]
                }
            ],
            "createdAt": "2026-06-01T08:00:00.000Z",
            "updatedAt": "2026-06-20T12:00:00.000Z"
        }
    ]
}
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
Previous
Lists ticket categories
Next
Lists service categories of an office
Built with