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 a1DAYorg bucket equals the sum of its devices’ daily figures 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. Amounts are in the org’s currency (currency on the
default shape, metadata.currency on the others): each day converts from the stored EUR at
that day’s rate, like the per-device /savings/daily, so a 1DAY bucket equals the sum of its
devices’ daily figures.
Restricted to support and admins, plus Console Support agents reading across organisations.
