---
title: "GET /detect/mitigationactions/executions"
method: GET
path: "/detect/mitigationactions/executions"
---

# GET /detect/mitigationactions/executions

`GET /detect/mitigationactions/executions`

Lists mitigation actions executions for a Device Defender ML Detect Security Profile.

Requires permission to access the [ListDetectMitigationActionsExecutions](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Query parameters

- `taskId` string
- `violationId` string
- `thingName` string
- `startTime` string, date-time
- `endTime` string, date-time
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListDetectMitigationActionsExecutionsResponse
  - `actionsExecutions` DetectMitigationActionExecution[] — List of actions executions.
    - `taskId` string — The unique identifier of the task.
    - `violationId` string — The unique identifier of the violation.
    - `actionName` string — The friendly name that uniquely identifies the mitigation action.
    - `thingName` string — The name of the thing.
    - `executionStartDate` string, date-time — The date a mitigation action was started.
    - `executionEndDate` string, date-time — The date a mitigation action ended.
    - `status` 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED' | 'SKIPPED' — The status of a mitigation action.
    - `errorCode` string — The error code of a mitigation action.
    - `message` string — The message of a mitigation action.
  - `nextToken` string — A token that can be used to retrieve the next set of results, or <code>null</code> if there are no additional results.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — InternalFailureException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)