---
title: "Query timeseries over a time range via PromQL."
method: GET
path: "/projects/{project_id}/metrics/timeseries/api/v1/query-range"
tags: ["Observability"]
---

# Query timeseries over a time range via PromQL.

`GET /projects/{project_id}/metrics/timeseries/api/v1/query-range`

## Path parameters

- `project_id` string, required

## Query parameters

- `query` string, required
- `start` string, required
- `end` string, required
- `step` string, required
- `timeout` string
- `limit` string

## Response `200`

- ObservabilityMetrics — see also https://prometheus.io/docs/prometheus/latest/querying/api/
  - `data` string, required
  - `error` string
  - `errorType` string
  - `infos` string[]
  - `status` string, required
  - `warnings` string[]

## Other responses

- `400` — Error Bad Request
- `401` — Error Authentication Failed
- `403` — Error Permissions
- `500` — Error Internal Server

---

[API](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway.md) · [All operations](https://skmtc.net/crusoecloud/apis/crusoe-cloud-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crusoecloud/crusoe-cloud-api-gateway/versions/a3fd2dedc72b/schema)