1. Sensors
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
      • Lists room bookings
      • Creates a room booking
      • 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
        GET
  • MCP server
    • Overview
    • Authentication
    • Tools reference
  • 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
  1. Sensors

Lists company monitors

GET
/sensors/monitors
Retrieves a paginated list of the monitors detected across the company, each with the desk it is mapped to and when it was last seen connected. Monitors that are not mapped to a desk are included with a null mapping, unless the results are narrowed to a single office. Office, floor, area and desk names are null when the location has since been deleted. Timestamps are returned in UTC; use the office's timeZone to present them in local time. Monitors are ordered by when they were first detected, newest first. Supports filtering by office, and results are paginated using limit and offset parameters.

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/sensors/monitors?offset=undefined&limit=undefined&officeId=undefined' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
List of monitors matching the provided filters
Bodyapplication/json

Example
{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "manufacturer": "Dell",
            "manufacturerId": "DEL",
            "displayName": "DELL U2722D",
            "serialNumber": "ABC12345",
            "productCode": "U2722D",
            "state": "ACTIVE",
            "lastConnectionAt": "2026-04-02T08:15:00.000Z",
            "mapping": {
                "office": {
                    "id": "df59a523-439f-42c6-93a9-df2c115f05e7",
                    "name": "Munich HQ",
                    "timeZone": "Europe/Berlin"
                },
                "floor": {
                    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
                    "name": "Floor 1"
                },
                "area": {
                    "id": "e1eebc99-9c0b-4ef8-bb6d-6bb9bd380e11",
                    "name": "North Wing"
                },
                "desk": {
                    "id": "6f244e73-26a8-41f3-849e-892244ae24e6",
                    "name": "Desk 12"
                },
                "mappedAt": "2026-01-15T09:30:00.000Z"
            }
        }
    ]
}
🟠401Unauthorized
🟠403Forbidden
Previous
Updates a ticket
Next
MCP server
Built with