Execute a range query

POST 
/query_range

Evaluates an expression query over a range of time. Returns a matrix result type with time series data points.

This endpoint is subject to the API's query limits and query freshness behavior.

Request

Responses

200

Successful range query execution

400

Bad request — invalid or unparseable parameters (for example, a malformed PromQL expression or timestamp), or a query that exceeds the query limits (too many series, time range too long, or too many result points). Returned as a Prometheus-style JSON error with errorType: bad_data.

401

Unauthorized — missing or invalid authentication. Triggered when the Authorization header is absent or the access key (Client ID / Client Secret) is invalid. Returned as a plain-text body, for example missing Authorization request header.

422

Unprocessable entity — the backend could not execute the query. Try adjusting the query, time range, or step and retry. Returned as a Prometheus-style JSON error.

500

Internal server error — an unexpected failure while resolving metrics or executing the query. Returned as a Prometheus-style JSON error.