RegisteredDevices
Search RegisteredDevices
Search and list RegisteredDevice records with filtering, sorting, and pagination.
GET
Search RegisteredDevices
A registered device is an integration hardware or software client associated with a location; operators can identify it, review its status, and enable or disable it.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the
Authorization header.
The authenticated user must be a full unrestricted administrator or have the RegisteredDevice-List role.Query Parameters
Pagination & Sorting
Filters
Filter by iD of the location the device is associated with; association is managed by the device association workflow..
Filter by iD of the internal user account provisioned for the associated device; managed by the device association workflow and not available for agent use..
Filter by read-only device type assigned during registration; it determines the device’s authentication and permission behavior..
Filter by read-only unique identifier supplied by the device during registration and used for device authentication and messaging..
Filter by internal JSON configuration returned directly to the device; integration-specific and not available for agent use..
Filter by whether the device can authenticate, associate with a location, send heartbeats, and submit logs; inactive devices cannot perform these operations..
Filter by read-only UTC date and time of the most recent device registration, heartbeat, or log submission..
Range Filters
Filter by read-only UTC date and time of the most recent device registration, heartbeat, or log submission. greater than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Filter by read-only UTC date and time of the most recent device registration, heartbeat, or log submission. less than or equal to this value. Format:
YYYY-MM-DDTHH:mm.Code Examples
Simple listing
Filtering by Name
Range filters
Response
200
The list of RegisteredDevice records matching the query. See the Get one RegisteredDevice endpoint for the full list of properties returned for each record.
Example Response