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

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

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

## Request

- Base URL: `https://management.azure.com`
- URL: `https://management.azure.com/{resourceId}/providers/Microsoft.PolicyInsights/remediations/{remediationName}/listDeployments`
- Auth: OAuth 2
  - Implicit: `https://login.microsoftonline.com/common/oauth2/authorize`
  - Scopes: `user_impersonation`

Gets all deployments for a remediation at resource scope.

## Path parameters

- `resourceId` 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.dev/azure/apis/remediationsclient.md) - [All operations](https://skmtc.dev/azure/apis/remediationsclient/llms.txt) - [OpenAPI document](https://skmtc.dev/azure/apis/remediationsclient/revisions/1cf51ae76be4?raw)
