---
title: "List Related Incidents"
method: GET
path: "/data/v1/incidents/{INCIDENT_ID}/related"
tags: ["Incidents"]
---

# List Related Incidents

`GET /data/v1/incidents/{INCIDENT_ID}/related`

## Request

- Base URL: `https://api.mux.com`
- URL: `https://api.mux.com/data/v1/incidents/{INCIDENT_ID}/related`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns all the incidents that seem related to a specific incident.

## Path parameters

- `INCIDENT_ID` string, required

## Query parameters

- `limit` integer
- `page` integer
- `order_by` 'negative_impact' | 'value' | 'views' | 'field'
- `order_direction` 'asc' | 'desc'

## Response `200`

OK

- ListRelatedIncidentsResponse
  - `data` Incident[], required
    - `threshold` number, double, required
    - `status` string, required
    - `started_at` string, required
    - `severity` string, required
    - `sample_size_unit` string, required
    - `sample_size` integer, required
    - `resolved_at` string, nullable, required
    - `notifications` IncidentNotification[], required
      - `queued_at` string, required
      - `id` integer, required
      - `attempted_at` string, required
    - `notification_rules` IncidentNotificationRule[], required
      - `status` string, required
      - `rules` NotificationRule[], required
        - `value` string, required
        - `name` string, required
        - `id` string, required
      - `property_id` string, required
      - `id` string, required
      - `action` string, required
    - `measurement` string, required
    - `measured_value_on_close` number, double, nullable, required
    - `measured_value` number, double, nullable, required
    - `incident_key` string, required
    - `impact` string, required
    - `id` string, required
    - `error_description` string, required
    - `description` string, required
    - `breakdowns` IncidentBreakdown[], required
      - `value` string, required
      - `name` string, required
      - `id` string, required
    - `affected_views_per_hour_on_open` integer, required
    - `affected_views_per_hour` integer, required
    - `affected_views` integer, required
  - `total_row_count` integer, nullable, required
  - `timeframe` integer[], required

## Changes

- **2025-08-05** `ba7ebfd893a1`: 1 info
  - the endpoint scheme security `authorizationToken` was added to the API
- **2025-07-02** `d4d7fca3b738`: 1 info
  - the endpoint scheme security `accessToken` was added to the API

[Operation history](https://skmtc.dev/muxinc/apis/mux-api/changes/data/v1/incidents/:INCIDENT_ID/related/get.md)

---

[API](https://skmtc.dev/muxinc/apis/mux-api.md) - [All operations](https://skmtc.dev/muxinc/apis/mux-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muxinc/apis/mux-api/revisions/75b4251a1d96?raw)