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

# POST /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/listDeployments

`POST /subscriptions/{subscriptionId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/listDeployments`

Gets all deployments for a remediation at subscription scope.

## Path parameters

- `subscriptionId` string, required
- `remediationName` string, required

## Query parameters

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

## Response `200`

The retrieved remediation deployments.

- RemediationDeploymentsListResult — List of deployments for a remediation.
  - `value` RemediationDeployment[] — Array of deployments for the remediation.
    - `remediatedResourceId` string — Resource ID of the resource that is being remediated by the deployment.
    - `deploymentId` string — Resource ID of the template deployment that will remediate the resource.
    - `status` string — Status of the remediation deployment.
    - `resourceLocation` string — Location of the resource that is being remediated.
    - `error` ErrorDefinition — Error definition.
      - `code` string — Service specific error code which serves as the substatus for the HTTP error code.
      - `message` string — Description of the error.
      - `target` string — The target of the error.
      - `details` ErrorDefinition[] — Internal error details.
      - `additionalInfo` TypedErrorInfo[] — Additional scenario specific error details.
        - `type` string — The type of included error details.
        - `info` unknown
    - `createdOn` string, date-time — The time at which the remediation was created.
    - `lastUpdatedOn` string, date-time — The time at which the remediation deployment was last updated.
  - `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)
