---
title: "List an incident's impacts"
method: GET
path: "/api/v2/incidents/{incident_id}/impacts"
tags: ["Incidents"]
---

# List an incident's impacts

`GET /api/v2/incidents/{incident_id}/impacts`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/incidents/{incident_id}/impacts`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `incident_read`

Get all impacts for an incident.

## Path parameters

- `incident_id` string, required

## Query parameters

- `include` IncidentImpactRelatedObject[]

## Response `200`

OK

- IncidentImpactsResponse: Response with a list of incident impacts.
  - `data` IncidentImpactResponseData[], required: An array of incident impacts.
    - `attributes` IncidentImpactAttributes: The incident impact's attributes.
      - `created` string, date-time: Timestamp when the impact was created.
      - `description` string, required: Description of the impact.
      - `end_at` string, date-time, nullable: Timestamp when the impact ended.
      - `fields` IncidentImpactFieldsObject, nullable: An object mapping impact field names to field values.
      - `impact_type` string: The type of impact.
      - `modified` string, date-time: Timestamp when the impact was last modified.
      - `start_at` string, date-time, required: Timestamp representing when the impact started.
    - `id` string, required: The incident impact's ID.
    - `relationships` IncidentImpactRelationships: The incident impact's resource relationships.
      - `created_by_user` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
      - `incident` RelationshipToIncident: Relationship to incident.
        - `data` RelationshipToIncidentData, required: Relationship to incident object.
          - `id` string, required: A unique identifier that represents the incident.
          - `type` 'incidents', required: Incident resource type.
      - `last_modified_by_user` RelationshipToUser: Relationship to user.
        - `data` RelationshipToUserData, required: Relationship to user object.
          - `id` string, required: A unique identifier that represents the user.
          - `type` 'users', required: Users resource type.
    - `type` 'incident_impacts', required: Incident impact resource type.
  - `included` IncidentUserData[]: Included related resources that the user requested.
    - `attributes` IncidentUserAttributes: Attributes of user object returned by the API.
      - `email` string: Email of the user.
      - `handle` string: Handle of the user.
      - `icon` string: URL of the user's icon.
      - `name` string, nullable: Name of the user.
      - `uuid` string: UUID of the user.
    - `id` string: ID of the user.
    - `type` 'users': Users resource type.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)