Documentation

Get seen devices

Description

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.

Request

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

Response

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: “”)

Example

Request

curl "https://api.cloud.nabto.com/v1/domains/:domain/seen-devices" \
  -H "Authorization: Bearer <ApiKey>" \
  -H "X-Nabto-Organization: <OrganizationId>"

Response

{
   devices: [{
     deviceId: "a.mydomain.example.net",
    region: "<region>",
    lastUpdate: "2022-10-18T10:17:24.299Z" 
  },
  ...]
}