---
title: "List alert escalations"
method: GET
path: "/v1/alerts/escalations"
tags: ["External API"]
---

# List alert escalations

`GET /v1/alerts/escalations`

List alerts that Alert Intelligence escalated for investigation, with their root-cause summaries. Filter by time range (`start_time` / `end_time`, timezone-aware ISO-8601). Pagination uses `page` + `limit` (max 100).

## Query parameters

- `start_time` string, date-time, nullable — Inclusive lower bound on when the alert fired (ISO-8601, UTC).
- `end_time` string, date-time, nullable — Exclusive upper bound on when the alert fired (ISO-8601, UTC).
- `page` integer, nullable — 1-indexed page number.
- `limit` integer, nullable — Page size (max 100).

## Response `200`

Successful Response

- ListEscalationsResponse — Paginated list of escalated alerts.
  - `escalations` AlertEscalationItem[], required — Escalations in the current page.
    - `alert_name` string, nullable — Alert name.
    - `title` string, required — Alert monitor name, or alert name if the monitor name is unavailable.
    - `description` string, required — Alert description.
    - `escalation_time` string, required — When the alert was escalated (ISO-8601).
    - `markdown_summary` string — Markdown summary of the investigation's findings.
    - `num_related_alerts` integer — Number of related alerts.
    - `session_id` string, required — Associated investigation session ID.
    - `source_integration` string, nullable — Source integration (e.g., DATADOG).
    - `instance_group_variables` object — Parsed instance group variables (e.g., environment, kube_cluster_name).
  - `count` integer, required — Number of escalations in the current page.
  - `total` integer, required — Total number of escalations across all pages.
  - `prev` integer, nullable — Previous page number, if any.
  - `next` integer, nullable — Next page number, if any.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)