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
      • 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
      GET
  • Visitors
    • Lists company visit types
  • 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
    • VisitTypeResponse
    • EnvelopedVisitTypeResponse
  1. Sensors

Lists company network configurations

GET
/sensors/networks
Retrieves a paginated list of the network configurations used to detect office presence across the company. Each configuration belongs to one office and carries the network values it matches on (public IPs and ranges, gateway IPs and MACs, subnets, SSIDs and BSSIDs; unused families are empty arrays), plus the values it shares with other offices' configurations — shared values mean office detection cannot tell those offices apart. Configurations are ordered by name. 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/networks?offset=undefined&limit=undefined&officeId=undefined' \
--header 'Authorization: Bearer <token>'

Responses

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

Example
{
    "total": 100,
    "limit": 10,
    "offset": 0,
    "data": [
        {
            "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "officeId": "df59a523-439f-42c6-93a9-df2c115f05e7",
            "name": "HQ Wi-Fi",
            "publicIpAddresses": [
                "203.0.113.10"
            ],
            "publicIpRanges": [
                "203.0.113.0/24"
            ],
            "gatewayIpAddresses": [
                "10.0.0.1"
            ],
            "gatewayMacAddresses": [
                "aa:bb:cc:dd:ee:ff"
            ],
            "subnets": [
                "10.20.0.0/16"
            ],
            "ssids": [
                "CorpNet"
            ],
            "bssids": [
                "11:22:33:44:55:66"
            ],
            "conflicts": [
                {
                    "officeId": "df59a523-439f-42c6-93a9-df2c115f05e7",
                    "officeName": "Munich HQ",
                    "signal": "publicIp",
                    "value": "CorpNet"
                }
            ]
        }
    ]
}
🟠401Unauthorized
🟠403Forbidden
Previous
Tools reference
Next
Lists company visit types
Built with