---
title: "List Highlighted Escalations"
method: GET
path: "/v2/alerts/highlighted-escalations"
---

# List Highlighted Escalations

`GET /v2/alerts/highlighted-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/v2/alerts/highlighted-escalations`
- Auth: none declared

List highlighted escalations, paginated.

Returns escalated MIM alerts for Pepsi, and all escalated alerts for other orgs.

Args:
    authorized_user: Authorized user with organization context
    search_query: Optional search over alert name and description
    page: Page number for pagination (default: 1)
    limit: Number of escalations per page (default: 10)

Returns:
    AlertEscalationResponse containing highlighted escalations

## Query parameters

- `search_query` string, nullable: Search over alert name and description
- `page` integer: Page number for pagination (default: 1)
- `limit` integer: Number of escalations per page (default: 10)

## Response `200`

Successful Response

- AlertEscalationResponse: Response model for listing alert escalations with pagination.
  - `escalations` AlertEscalation[], required: List of alert escalations
    - `alert_name` string, nullable: Alert name
    - `description` string, required: Alert description
    - `escalation_time` string, required: When the alert was escalated (ISO datestring)
    - `markdown_summary` string: Markdown summary of the escalation
    - `num_related_alerts` integer: Number of related alerts
    - `session_id` string, required: Associated triage session ID
    - `assistant_chat_id` string, nullable: Chat message ID from which the markdown summary was extracted
    - `source_integration` string, nullable: Source integration
    - `title` string, required: Alert monitor name, or alert name if monitor name is unavailable
    - `instance_group_variables` object: Parsed instance group variables (e.g., environment, kube_cluster_name)
  - `count` integer, required: Number of escalations in current page
  - `total` integer, required: Total number of escalations across all pages
  - `prev_page` integer, nullable: Previous page number
  - `next_page` integer, nullable: Next page number

## Other responses

- `422`: Validation Error

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-04** `928d9e3914b0`: 1 info
  - added the new optional `query` request parameter `search_query`
- **2026-09-03** `b68d9bf4b28f`: 3 info
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `page`
  - added the non-success response with the status `422`

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/v2/alerts/highlighted-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)