---
title: "List alert rules"
method: GET
path: "/v1/alert-rules"
---

# List alert rules

`GET /v1/alert-rules`

List alert rules with optional filters.

## Query parameters

- `enabled` boolean
- `metric` 'turn_latency_p50' | 'turn_latency_p95' | 'api_errors' | 'function_errors' | 'call_crashes' | 'call_volume' — Metric to monitor.
- `project_id` string
- `state` 'ok' | 'alert' | 'no_data' | 'unknown' — Current state of an alert rule.

## Response `200`

Alert rules retrieved successfully.

- AlertRuleListResponse — Every alert rule in scope, each with its current state.
  - `data` AlertRuleResponse[], required — An alert rule: its trigger condition, evaluation window, and current state.
    - `id` string, required — Alert rule ID
    - `name` string, required — Alert rule name
    - `project_id` string, nullable — Project ID
    - `metric` 'turn_latency_p50' | 'turn_latency_p95' | 'api_errors' | 'function_errors' | 'call_crashes' | 'call_volume', required — Metric to monitor.
    - `operator` '>' | '<' | '>=' | '<=', required — Comparison operator used by the alert rule.
    - `threshold_value` integer, required — Threshold value
    - `window_duration` '5m' | '10m' | '60m', required — Evaluation window duration. Allowed values: `5m`, `10m`, or `60m`.
    - `enabled` boolean, required — Whether the alert is enabled
    - `current_state` 'ok' | 'alert' | 'no_data' | 'unknown' — Current state of an alert rule.
    - `since` string, date-time, nullable — When the current state started
    - `last_evaluated_at` string, date-time, nullable — Last evaluation timestamp
    - `current_value` integer, nullable — Current metric value
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp

## Other responses

- `400` — Validation error.
- `401` — Missing or invalid API key.
- `500` — Internal server error.

---

[API](https://skmtc.net/poly/apis/polyai-agents-api.md) · [All operations](https://skmtc.net/poly/apis/polyai-agents-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poly/polyai-agents-api/versions/76f3c606e395/schema)