Get an Organisation's Devices Savings
Get the savings for the specified organization ID within a date range.
Three response shapes, driven by the optional params (default = single range total split by device class, backwards-compatible):
resolution=→{metadata, data: [{start_period, end_period, total_savings, <class>_savings…}]}, one bucket per calendar period. Buckets use the sameTrunc*/UTC daily-row semantics as the per-device savings endpoints, so an org bucket equals the sum of its per-device buckets and the series sums to the range total (full periods only — a partial trailing period is dropped).by=device/by=device_type/by=oem→{metadata, data:[…range totals…]}.by=devicereturns one page of the extremes — the toplimitby savings,order=desc(best savers) orasc(worst performers);by=oemgroups by device-model manufacturer (merged across classes), so whole-fleet and per-OEM aggregates come fromdevice_type/oem, not the per-device list.
resolution and by are mutually exclusive — a bucketed org series XOR range-total
breakdowns, never the cross product. metadata.currency is the org’s currency code; amounts
are the raw stored values (EUR today) — no FX conversion, no exchange_rate field.
Restricted to staff and admins, plus Console Support agents reading across organisations.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
The organization ID of the user's organization
Query Parameters
Start datetime for savings calculation
End datetime for savings calculation
Bucket the org total into a time series (1DAY/1WEEK/1MONTH/1QUARTER/1YEAR). Mutually exclusive with by.
Range-total breakdown: device, device_type, or oem (manufacturer). Mutually exclusive with resolution.
Max rows for by=device (the top savers by range total). Ignored by other modes.
1 <= x <= 1000Sort direction for by=device by savings: desc (best savers) or asc (worst performers). Ignored by other modes.
