---
title: "Prometheus Query Range"
method: GET
path: "/api/v1/query_range"
tags: ["Prometheus"]
---

# Prometheus Query Range

`GET /api/v1/query_range`

Prometheus query_range API.

## Query parameters

- `query` string — The query expression of prometheus to filter.
- `start` string — The start time to filter.
- `end` string — The end time to filter.
- `step` string — The step to filter.
- `timeout` string — The timeout to filter.

## Response `200`

OK

- PrometheusQueryRangeResponse
  - `status` string, required — Prometheus status
  - `errorType` string, nullable — Prometheus error type
  - `error` string, nullable — Prometheus error
  - `warnings` string, nullable — Prometheus warnings
  - `data` PrometheusQueryRangeData
    - `resultType` string, required — Prometheus result type
    - `result` PrometheusQueryRangeResult[], required — Prometheus query range result
      - `metric` object, required — Prometheus metric
      - `value` unknown[], required — Prometheus metric value
        - unknown

## Other responses

- `401` — Unauthorized
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

> 14 revisions in range; 1 could not be searched.

- **2025-07-21** `69284996eaa6` — 3 breaking, 2 info
  - response property `error` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `errorType` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `warnings` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - removed `#/components/schemas/PrometheusQueryRangeData` from the `data` response property `allOf` list for the response status `200`
  - …1 more
- **2025-06-24** `0c09cad5e8d9` — 1 breaking
  - response property `detail/items/loc/items/` list-of-types was widened by adding types `integer` to media type `application/json` of response `422`
- **2022-08-19** `033c8fe2fe57` — 2 warning, 6 info
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
  - added `#/components/schemas/PrometheusQueryRangeData` to the `data` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/PrometheusQueryRangeData, subschema #2` from the `data` response property `anyOf` list for the response status `200`
  - …4 more

[Change history](https://skmtc.dev/openstack/apis/skyline-api/changes/api/v1/query_range/get.md)

---

[API](https://skmtc.dev/openstack/apis/skyline-api.md) · [All operations](https://skmtc.dev/openstack/apis/skyline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openstack/skyline-api/revisions/4b7c0ce8c025/schema)