---
title: "List metric measurement values, grouped by attributes, filtered by the filter. An empty list indicates no data points are available for the given parameters."
method: GET
path: "/v1/metrics/{name}/measurements"
tags: ["metrics"]
---

# List metric measurement values, grouped by attributes, filtered by the filter. An empty list indicates no data points are available for the given parameters.

`GET /v1/metrics/{name}/measurements`

## Path parameters

- `name` string, required

## Query parameters

- `filter` string
- `groupBy` string
- `aggregateBy` 'AVG' | 'COUNT' | 'MIN' | 'MAX' | 'SUM' | 'LAST'
- `preGroupBy` string
- `preGroupByMethod` 'AVG' | 'COUNT' | 'MIN' | 'MAX' | 'SUM' | 'LAST'
- `seriesType` 'TIMESERIES' | 'SCALAR', required
- `startTime` string, date-time
- `endTime` string, date-time
- `pageSize` integer
- `skipToken` string

## Response `200`

The request has succeeded.

- object
  - `groupings` MetricsGrouping[], required — Measurement data grouped by attributes.
    - `attributes` CommonKeyValuePair[], required — Attribute key-value pairs identifying this grouping.
      - `key` string, required — Key.
      - `value` string, required — Value.
    - `measurements` MetricsMeasurement[], required — An empty list indicates no data points are available.
      - `time` string, date-time, required — Time of the measurement.
      - `value` number, double, nullable, required — Value of the measurement.
  - `bucketSizeInSeconds` integer, required — Bucket size used for computing time series points, in seconds.
  - `pageInfo` CommonPageInfo, required
    - `prevPage` string, required — Token for the previous page, or empty string if on the first page.
    - `nextPage` string, required — Token for the next page, or empty string if on the last page.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `404` — The server cannot find the requested resource.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/versions/994e5ca64961/schema)