---
title: "List the metric values for a load test run."
method: POST
path: "/test-runs/{testRunId}/metrics"
tags: ["TestRun"]
---

# List the metric values for a load test run.

`POST /test-runs/{testRunId}/metrics`

List the metric values for a load test run.

## Path parameters

- `testRunId` string, required

## Query parameters

- `api-version` string, required
- `aggregation` string
- `metricname` string, required
- `interval` 'PT5S' | 'PT10S' | 'PT1M' | 'PT5M' | 'PT1H'
- `metricNamespace` string, required
- `timespan` string, required

## Request body

- MetricRequestPayload — Filters to fetch the set of metric.
  - `filters` DimensionFilter[] — Get metrics for specific dimension values. Example: Metric contains dimension like SamplerName, Error. To retrieve all the time series data where SamplerName is equals to HTTPRequest1 or HTTPRequest2, the DimensionFilter value will be {"SamplerName", ["HTTPRequest1", "HTTPRequest2"}
    - `name` string — The dimension name
    - `values` string[] — The dimension values. Maximum values can be 20.

## Response `200`

The request has succeeded.

- Metrics — The response to a metrics query.
  - `value` TimeSeriesElement[], required — The TimeSeriesElement items on this page
    - `data` MetricValue[] — An array of data points representing the metric values.
      - `timestamp` string, date-time — The timestamp for the metric value in RFC 3339 format.
      - `value` number, double — The metric value.
    - `dimensionValues` DimensionValue[] — The dimension values
      - `name` string — The name of the dimension.
      - `value` string — The value of the dimension.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

---

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