---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations"
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations

`GET /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations`

Gets all remediations for the subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `$top` integer
- `$filter` string
- `api-version` string, required

## Response `200`

The retrieved remediations.

- RemediationListResult — List of remediations.
  - `value` Remediation[] — Array of remediation definitions.
    - `properties` RemediationProperties — The remediation properties.
      - `policyAssignmentId` string — The resource ID of the policy assignment that should be remediated.
      - `policyDefinitionReferenceId` string — The policy definition reference ID of the individual definition that should be remediated. Required when the policy assignment being remediated assigns a policy set definition.
      - `resourceDiscoveryMode` 'ExistingNonCompliant' | 'ReEvaluateCompliance' — The way resources to remediate are discovered. Defaults to ExistingNonCompliant if not specified.
      - `provisioningState` string — The status of the remediation.
      - `createdOn` string, date-time — The time at which the remediation was created.
      - `lastUpdatedOn` string, date-time — The time at which the remediation was last updated.
      - `filters` RemediationFilters — The filters that will be applied to determine which resources to remediate.
        - `locations` string[] — The resource locations that will be remediated.
      - `deploymentStatus` RemediationDeploymentSummary — The deployment status summary for all deployments created by the remediation.
        - `totalDeployments` integer — The number of deployments required by the remediation.
        - `successfulDeployments` integer — The number of deployments required by the remediation that have succeeded.
        - `failedDeployments` integer — The number of deployments required by the remediation that have failed.
    - `id` string — The ID of the remediation.
    - `type` string — The type of the remediation.
    - `name` string — The name of the remediation.
  - `nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — Error response describing why the operation failed.

---

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