Devices
List Devices
Retrieves a list of network devices belonging to the authenticated customer, with filtering and pagination.
GET
Authorizations
Enter the Bearer token (obtained via authentication or provided internally).
Query Parameters
Filter by MAC address (partial match).
Maximum length:
17
Filter by hostname (partial match).
Maximum length:
255
Filter by alias (partial match).
Maximum length:
255
Filter by manufacturer (partial match).
Maximum length:
255
Filter by site UUID (partial match).
Filter by associated IP address (checks history, partial match).
Maximum length:
45
Only return devices with a current IP.
Filter by devices seen in the last N days.
Required range:
1 <= x <= 365
Available options:
mac_address
, hostname
, alias
, manufacturer
, created_at
, last_seen_at
Available options:
asc
, desc
Items per page for cursor pagination.
Required range:
5 <= x <= 5000
Pagination cursor.
Response
200
application/json
A paginated list of devices.
The response is of type object
.