---
title: "List Remediations"
method: GET
path: "/v1/incident_reports/{incident_report_id}/remediations"
tags: ["Incident Reports"]
---

# List Remediations

`GET /v1/incident_reports/{incident_report_id}/remediations`

## Request

- Base URL: `https://api.huntress.io`
- URL: `https://api.huntress.io/v1/incident_reports/{incident_report_id}/remediations`
- Auth: `basic` (a scheme the document does not define)

Shows details of Remediations belonging to a single Incident Report.

## Path parameters

- `incident_report_id` integer, required

## Query parameters

- `limit` integer
- `page_token` string
- `sort_field` 'id' | 'created_at' | 'updated_at'
- `sort_direction` 'asc' | 'desc'
- `types[]` string[]
- `statuses[]` string[]

## Response `200`

List Remediations

- object
  - `remediations` Remediation[], required
    - `id` integer: A unique identifier for a remediation.
    - `type` string: The type of the remediation. Can be one of: assisted, manual, containment
    - `action` string: Description of the remediation's required steps.
    - `parameters` string[]: Additional context on how the remediation will be performed.<br>For containment remediations, this will be a string showing the entity to which the remediation was applied.<br>For assisted remediations this will be an array of key value pairs representing all the parameters that are related to the remediation.<br>Manual remediations will have no information.
    - `status` string: The status of the remediation. Can be one of: unapproved, approved, completed, failed, cancelled
    - `approved_at` string, date-time: ISO-8601 formatted timestamp for when the remediation was approved.
    - `approved_by` User
      - `id` integer: A unique identifier for the user.
      - `email` string: The user's email.
      - `name` string: The user's name.
    - `completed_at` string, date-time: ISO-8601 formatted timestamp for when the remediation was completed.
  - `pagination` Pagination, required: Pagination model
    - `next_page_url` string
    - `next_page_token` string

## Other responses

- `403`: There was an issue with your API credential or permissions.

---

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