Get seen devices


Get list of devices seen online for a given domain. The returned list is paginated meaning it may not contain all seen devices for the domain. If additional devices exist, the HTTP link header will contain a next link for getting the next page of devices. If devices exists previous to the returned list, the HTTP link header will contain a prev link for getting the previous page of devices.


GET /v1/domains/:domain/seen-devices


Successful response contains the following JSON formated body:

  devices: {
    deviceId: string,
    region: string,
    lastUpdate: string

Response Status codes:

  • 200 on success

Request headers

This request must have the following headers:

  • Authorization: bearer <ApiKey>
  • X-Nabto-Organization: <organizationId>

Request Query Parameters

This request supports the following query parameters:

  • limit The pagination page size (max: 10000, default: 500)
  • deviceIdFilter is a partial device ID for searching (default: “”)



curl "" \
  -H "Authorization: Bearer <ApiKey>" \
  -H "X-Nabto-Organization: <OrganizationId>"


   devices: [{
     deviceId: "",
    region: "<region>",
    lastUpdate: "2022-10-18T10:17:24.299Z"