---
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. If you do not specify a $filter clause including a startTime or endTime these filters default to the start and end times of the last aggregation interval currently available; that is, only the last aggregation interval is returned.

## 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, uuid
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123

## Response `200`

A response containing the list of pool usage details.

- PoolListUsageMetricsResult
  - `odata.nextLink` string
  - `value` PoolUsageMetrics[]
    - `dataEgressGiB` number, double, required
    - `dataIngressGiB` number, double, required
    - `endTime` string, date-time, required
    - `poolId` string, required
    - `startTime` string, date-time, required
    - `totalCoreHours` number, double, required
    - `vmSize` string, required — For information about available sizes of virtual machines in pools, see Choose a VM size for compute nodes in an Azure Batch pool (https://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

## Other responses

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

---

[API](https://skmtc.net/windows/apis/batch-batchservice.md) · [All operations](https://skmtc.net/windows/apis/batch-batchservice/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/windows/batch-batchservice/revisions/9ab62bb93c5f/schema)