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

# List alert escalations

`GET /v1/alerts/escalations`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/v1/alerts/escalations`
- Auth: none declared

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

- `400`: The request contains an invalid value.
- `4XX`: Client error returned in the V1 error envelope.

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-08-26** `6ee9e975dda2`: 2 info
  - added the non-success response with the status `400`
  - removed the non-success response with the status `422`

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/v1/alerts/escalations/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)