---
title: "Get Latency Over Time"
method: GET
path: "/v1/telemetry/latency/{metric_name}"
tags: ["Dome", "Telemetry"]
---

# Get Latency Over Time

`GET /v1/telemetry/latency/{metric_name}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/vijilai/apis/vijil-console-api-combined/docs/v1/telemetry/latency/:metric_name/get.ts> (a function with typed inputs; its response is checked against the schema)

Get latency over time.

## Path parameters

- `metric_name` string, required

## Query parameters

- `time_range` '15m' | '30m' | '1h' | '2h' | '6h' | '1d' | '7d' | '30d': Time range: 15m, 30m, 1h, 2h, 6h, 1d, 7d, 30d
- `time_window` string: Time window for aggregation (e.g., '1m', '5m', '15m')
- `percentiles` string, nullable: Comma-separated list of percentiles to query (e.g., '0.5,0.95'). If not specified, defaults to [0.5, 0.9, 0.95, 0.99]
- `evaluation_id` string, nullable: Filter by evaluation ID
- `test_id` string, nullable: Filter by test ID
- `probe_id` string, nullable: Filter by probe ID
- `agent_configuration_id` string, nullable: Filter by agent configuration ID

## Response `200`

Successful Response

- LatencyOverTimeResponse[]
  - `metric_name` string, required: Name of the latency metric
  - `time_window` string, required: Time window used for aggregation (e.g., '1m')
  - `percentile` string, required: Percentile value (e.g., 'P50', 'P95')
  - `values` TimeSeriesPoint[], required: Latency data points over time
    - `timestamp` integer, required: Unix timestamp of the data point
    - `value` number, required: Value at this timestamp

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vijilai/apis/vijil-console-api-combined.md) - [All operations](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/llms.txt) - [OpenAPI document](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/revisions/a8b2ee2b2d06?raw)