---
title: "Lists the usage metrics, aggregated by pool across individual time intervals, for the specified account."
method: GET
path: "/poolusagemetrics"
tags: ["Pools"]
---

# Lists the usage metrics, aggregated by pool across individual time intervals, for the specified account.

`GET /poolusagemetrics`

If you do not specify a $filter clause including a poolId, the response includes all pools that existed in the account in the time range of the returned aggregation intervals.

## Query parameters

- `starttime` string, date-time
- `endtime` string, date-time
- `$filter` string
- `maxresults` integer
- `timeout` integer
- `api-version` string, required

## Headers

- `client-request-id` string
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123

## Response `200`

A response containing the list of pool usage details.

- PoolListPoolUsageMetricsResult
  - `value` PoolUsageMetrics[]
    - `poolId` string, required
    - `startTime` string, date-time, required
    - `endTime` string, date-time, required
    - `vmSize` string, required — For information about available sizes of virtual machines for Cloud Services pools (pools created with cloudServiceConfiguration), see Sizes for Cloud Services (http://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supports all Cloud Services VM sizes except ExtraSmall. For information about available VM sizes for pools using images from the Virtual Machines Marketplace (pools created with virtualMachineConfiguration) see Sizes for Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) or Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch supports all Azure VM sizes except STANDARD_A0 and those with premium storage (STANDARD_GS, STANDARD_DS, and STANDARD_DSV2 series).
    - `totalCoreHours` number, double, required
    - `dataIngressGiB` number, double, required
    - `dataEgressGiB` number, double, required
  - `odata.nextLink` string

## Other responses

- `default` — The error from the Batch service.

## Changes

- **2026-07-13** `6029498afb63` — 1 info
  - api operation id `Pool_ListPoolUsageMetrics` removed and replaced with `Pool_ListUsageMetrics`

[Change history](https://skmtc.dev/azure/apis/batch-batch/changes/poolusagemetrics/get.md)

---

[API](https://skmtc.dev/azure/apis/batch-batch.md) · [All operations](https://skmtc.dev/azure/apis/batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/batch-batch/revisions/86eccfb1f072/schema)