Devices

Paginated list of devices in the API key's organization. Use limit and offset to page through results, and pagination=true to receive a response that includes the total count.

Beta: these endpoints are in beta and may change based on customer feedback.

GET/deviceView example ↗

Returns devices belonging to the API key's organization, with offset-based pagination.

Query parameters

Name	Value	Description
limit number		Page size. Number of devices to return per request.
offset number		Number of devices to skip before returning results.
pagination boolean		When true, the response wraps the device array with a total count.
order asc \| desc		Sort direction.
orderBy string		Column to sort by.

Request

bash

curl "https://prod.bluebot.com/management/v1/device?limit=25&offset=0&pagination=true" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "bluebot-api-key: YOUR_API_KEY"

Set an API key in the header to try this request.

Example response

json

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "serialNumber": "BB-000123",
      "networkUniqueIdentifier": "0004A30B001A2B3C",
      "label": "Front yard meter",
      "active": true
    }
  ],
  "total": 137
}