Skip to main content
GET
Organization Service Health

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

Query Parameters

device_type
enum<string>
required

A device type's ORM relation name — and the key into its state-store binding.

The value doubles as the related-name used in ORM kwargs (e.g. HeatPumpDataPoint(heat_pump=…)), so this is a StrEnum to stay interchangeable with that string at those sites.

Available options:
heat_pump,
inverter,
electric_vehicle,
wallbox

Response

200 - application/json

OK

generated_at
string<date-time>
required
scope
FleetServiceHealthScope · object
required
coverage
FleetServiceHealthCoverage · object
required

How much of the population the sweep has reached. A device without a record counts as unknown. A device whose record outlived its 45-minute evaluation deadline counts in lapsed_devices and reads unknown, so a stopped sweep cannot leave its last verdicts standing.

overall
StatusSummaryOutput · object
required

One population's state distribution. healthy_share is healthy / evaluable and null when nothing could be evaluated; blocked devices stay in the response for the greyed-out share of the bar.

overall_reasons
ReasonCountOutput · object[]
required
services
ServiceCardOutput · object[]
required
contract
string
default:fleet-service-health
schema_version
integer
default:2