Get statistics by label

GET

/api/v1/groups/by-label/{key}

const url = 'http://localhost:3000/api/v1/groups/by-label/environment';
const options = {method: 'GET', headers: {'X-API-Key': '<X-API-Key>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url http://localhost:3000/api/v1/groups/by-label/environment \
  --header 'X-API-Key: <X-API-Key>'

Retrieves device statistics grouped by a specific label key.

Authorizations

api-key
bearer

Parameters

Path Parameters

key

required

string

Example

environment

Label key to group by

Responses

200

Statistics retrieved successfully

application/json

object

labelKey

required

The label key used for grouping

string

groups

required

Statistics for each label value

Array<object>

object

value

required

Label value

string

count

required

Number of devices with this label value

number

byStatus

required

Status breakdown for this group

object

online

required

Number of online devices

number

offline

required

Number of offline devices

number

pending

required

Number of pending devices

number

error

required

Number of devices in error state

number

total

required

Total number of devices across all groups

number

Example

{
  "labelKey": "environment",
  "groups": [
    {
      "value": "production",
      "count": 25,
      "byStatus": {
        "online": 45,
        "offline": 5,
        "pending": 2,
        "error": 1
      }
    }
  ],
  "total": 53
}

401

Unauthorized

403

Forbidden — caller lacks required permission