---
title: "Changes to Query a metric time series"
method: GET
path: "/v2/metrics/{metric_name}"
---

# Changes to Query a metric time series

`GET /v2/metrics/{metric_name}`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 2 of 13 revisions.

- **2026-09-23** `3f4075adad3d` — 2 info
- **2026-09-16** `de6b34bc4a4f` — 14 info

## Changes

- **2026-09-23** `3f4075adad3d` — 2 info
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `422`
- **2026-09-16** `de6b34bc4a4f` — 14 info
  - added the new optional `query` request parameter `dimensions`
  - `query` request parameter `labels` was deprecated
  - response property `oneOf[#/components/schemas/CounterMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/labels` deprecated
  - response property `oneOf[#/components/schemas/DistributionMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/labels` deprecated
  - response property `oneOf[#/components/schemas/GaugeMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/labels` deprecated
  - response property `oneOf[#/components/schemas/PercentilesMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/labels` deprecated
  - added the required property `oneOf[#/components/schemas/CounterMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/dimension_values` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/CounterMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/metric` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/DistributionMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/dimension_values` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/DistributionMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/metric` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/GaugeMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/dimension_values` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/GaugeMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/metric` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/PercentilesMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/dimension_values` to the response with the `200` status
  - added the required property `oneOf[#/components/schemas/PercentilesMetricSeries]/allOf[#/components/schemas/MetricSeriesBase]/metric` to the response with the `200` status

---

[Operation](https://skmtc.dev/vectara/apis/vectara-rest-api-v2/docs/v2/metrics/:metric_name/get.md) · [API](https://skmtc.dev/vectara/apis/vectara-rest-api-v2.md) · [Page](https://skmtc.dev/vectara/apis/vectara-rest-api-v2/changes/v2/metrics/:metric_name/get)