---
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`

## Request

- Base URL: `https://api.na-01.cloud.solarwinds.com`
- URL: `https://api.na-01.cloud.solarwinds.com/v1/metrics/{name}/measurements`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/solarwinds/apis/solarwinds-observability/docs/v1/metrics/:name/measurements/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/solarwinds/apis/solarwinds-observability.md) - [All operations](https://skmtc.dev/solarwinds/apis/solarwinds-observability/llms.txt) - [OpenAPI document](https://skmtc.dev/solarwinds/apis/solarwinds-observability/revisions/f01485d38ee8?raw)