Skip to main content
GET
Get an Organisation's Devices Summary

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

org_id
string<uuid>
required

The organization ID of the user's organization

Response

200 - application/json

OK

Whole-fleet device counts over the org's operational (non-soft-deleted) devices. health_tones and type_shares each sum to the operational-device total; savings_leg_counts covers only devices with a savings leg (wallboxes and devices without a mapped type have none).

health_tones
HealthToneCountsOutput · object
required

not_steered is the muted management bucket — connected and reporting, but nobody is steering it — so it is disjoint from the three health severities, not a subset of them.

type_shares
DeviceTypeShareCountsOutput · object
required
savings_leg_counts
SavingsLegCountsOutput · object
required
support_buckets
SupportBucketOutput · object[]
required

Operational devices per Support category, a device counted under a category when it holds a pending cue of it, and under none when it holds none.

health_buckets
HealthBucketOutput · object[]
required

Operational devices per service-health verdict, read from the device status projection (a device not yet swept counts as unknown).

deleted
integer
required

Soft-deleted devices of every kind, outside every count above.