---
title: "POST /v1/metric-query/query-range"
method: POST
path: "/v1/metric-query/query-range"
tags: ["MetricQuery"]
---

# POST /v1/metric-query/query-range

`POST /v1/metric-query/query-range`

QueryRange runs a range query over a time range (Prometheus /api/v1/query_range).

## Request body

- MarksmanApiV1MetricQueryRangeRequest — MetricQueryRangeRequest is the request for range query.
  - `uid` string
  - `query` string
  - `start` string — Start time (Unix seconds). If not set or zero, defaults to (end - 1h) or (now - 1h).
  - `end` string — End time (Unix seconds). If not set or zero, defaults to now.
  - `step` string — Step in seconds (e.g. 15, 60). If not set or zero, defaults to 60. When set, must be in (0, 86400].

## Response `200`

OK

- MarksmanApiV1MetricQueryRangeReply — MetricQueryRangeReply returns the response from Prometheus /api/v1/query_range as a structured any type.
  - `response` object

---

[API](https://skmtc.net/aide-family/apis/untitled-api-3.md) · [All operations](https://skmtc.net/aide-family/apis/untitled-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aide-family/untitled-api-3/versions/26ae221fccba/schema)