---
title: "Batch Utilization Data"
method: POST
path: "/v1/operations/utilization_data/aggregate"
tags: ["Operations Utilization"]
---

# Batch Utilization Data

`POST /v1/operations/utilization_data/aggregate`

Retrieve the Utilization Data for the specified Resource ids

## Request body

- UtilizationAggregationRequest
  - `tenant_ids` string[], required — List of tenant ids for which data needs to be passed.
  - `filters` QueryOperator
    - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)
  - `additional_filters` QueryOperator
    - `__type` string, required — Concrete type used for polymorphic deserialization (discriminator)
  - `start_date` string, date-time, required — specify the start date.
  - `end_date` string, date-time, required — specify the end date.

## Response `200`

Fetched

- UtilizationAggregateResponse
  - `results` ResourceLevelUtilizationAggregate[] — Resource Aggregate.
    - `resource_id` string — Unique Id of the resource for which utilization detail is being shown.
    - `service_account_id` string — Id of the service account to which the resource belongs to.
    - `platform` string — Name of the os for the instance or vm.
    - `resource_name` string — Name of the resource for which utilization detail is being shown.
    - `metric_data` KpiMetricAggregate
      - `cpu_utilization` MetricDetailedData[] — Statistics about the CPU Utilization.
        - `date` string, date-time — Time stamp For which metrics are being measured.
        - `value` number — Value for the metric in the provided time frame.
      - `memory_utilization` MetricDetailedData[] — Statistics about the Memory Utilization.
        - `date` string, date-time — Time stamp For which metrics are being measured.
        - `value` number — Value for the metric in the provided time frame.
      - `disk_space_utilization` DiskUtilizationBatchResponse[] — Statistics about the Disk Space Utilization.
        - `path` string — Path For which metrics are being measured.
        - `device` string — Device name For which metrics are being measured.
        - `fstype` string — Type of the disk partition for which metrics are being measured.
        - `values` DiskUtilizationMetricDetail[] — Data Related to the Disk Utilization Metric.
          - `date` string — Time stamp in string for which metrics are being measured.
          - `free` number — Free Space for the metric in the provided time frame.
          - `used` number — Utilized Space for the metric in the provided time frame.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/corestack/apis/corestack-external-api.md) · [All operations](https://skmtc.dev/corestack/apis/corestack-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corestack/corestack-external-api/revisions/bf2cdf20826d/schema)