---
title: "Get Space Utilization Histogram of roi(s). Please check the input descriptions to check its dependencies."
method: GET
path: "/metrics/space-utilization/histogram"
tags: ["metrics"]
---

# Get Space Utilization Histogram of roi(s). Please check the input descriptions to check its dependencies.

`GET /metrics/space-utilization/histogram`

## Query parameters

- `roiIds` string[]
- `fromTimestamp` string, date-time
- `toTimestamp` string, date-time
- `minutesAgo` integer
- `bucketCount` integer

## Response `200`

Successful Operation.

- SpaceUtilizationHistogram
  - `bucketSizeInSec` integer, required
  - `rois` object[], required
    - `id` string, required
    - `histogram` object[], required
      - `start` string, date-time, required
      - `end` string, date-time, required
      - `metrics` object, required
        - `avgUtilizableFreeSpace` number, double, required
        - `avgSpaceUtilization` number, double, required
        - `avgSpaceOccupied` number, double, required
        - `avgTotalSpace` number, double, required
        - `avgFreeSpaceQuality` number, double, required
        - `avgNumExtraPallets` number, double, required
        - `avgFreeSpace` number, double, required

## Other responses

- `400` — Bad Request. This response will be sent if any of the required params are not present or if extra params are passed. It will also be sent if parameter dependencies (mentioned in parameter descriptions) are not satisfied.
- `404` — Resource Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/nvidia/apis/vss-video-analytics-apis.md) · [All operations](https://skmtc.net/nvidia/apis/vss-video-analytics-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nvidia/vss-video-analytics-apis/versions/0ff2b2f41244/schema)