Read customer pool utilization from retained device hours
Read-only and available to account members. Defaults to the last 168 complete hours, ending at the current UTC hour. From is inclusive and to is exclusive. Both must align to UTC hours and the window must be positive and at most 31 days. Future or incomplete hours are rejected. Day buckets follow UTC calendar boundaries and may have shorter first or last buckets. The response includes current hosts without evidence and removed hosts with retained history. Queries never read raw telemetry. Requests over 100000 device-hour rows or host buckets return 422 instead of partial totals. Narrow the time window to retry.
Request
- Base URL/ (relative, and the document was published on a file host, not at the API’s origin)
- AuthHTTP bearer
Path parameters
Identifier returned by Nodus.
Query parameters
Inclusive RFC3339 UTC-hour boundary. Defaults to 168 hours before to.
Exclusive RFC3339 UTC-hour boundary. Defaults to the current UTC hour.
Group retained hours by hour or UTC calendar day.
Response
Retained utilization and explicit measurement availability.
Changes
No recorded changes to this operation across all 70 revisions of this API.