---
title: "List metrics"
method: GET
path: "/v1/metrics"
tags: ["metrics"]
---

# List metrics

`GET /v1/metrics`

List metrics available within a time period.

## Query parameters

- `name` string
- `startTime` string, date-time
- `endTime` string, date-time
- `pageSize` integer
- `skipToken` string

## Response `200`

The request has succeeded.

- object
  - `metricsInfo` CommonMetricInfo[], required — List of metric metadata.
    - `name` string, required — Name of the metric.
    - `displayName` string, nullable — Display name of the metric. A short description of the metric.
    - `description` string, nullable — Description of the metric. A detailed description of the metric.
    - `units` string, nullable — Unit of the metric.
    - `formula` string, nullable — Formula of the metric.
    - `lastReportedTime` string, date-time, nullable — Last reported time of the metric.
  - `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.
- `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/revisions/994e5ca64961/schema)