---
search:
  tags:
    - metrics
    - POST
seo:
  description: >-
    Execute PromQL range query. Reference for the POST
    /api/v1/promql/query_range endpoint in the TimescaleDB Enterprise API.
sidebar:
  label: Run a PromQL range query
  badge: POST
title: Run a PromQL range query
type: openapi-operation
---
Execute PromQL range query.

`POST /api/v1/promql/query_range`

**Request body** (`application/json`, required)

- `end` (string, required)
- `query` (string, required)
- `start` (string, required)
- `step` (string, required)

Request body example:

```json
{
  "end": "string",
  "query": "string",
  "start": "string",
  "step": "string"
}
```

**Responses**

- `200` — OK
- `default` — Error
