---
title: "GET /greengrass/v2/deployments"
method: GET
path: "/greengrass/v2/deployments"
---

# GET /greengrass/v2/deployments

`GET /greengrass/v2/deployments`

Retrieves a paginated list of deployments.

## Query parameters

- `targetArn` string
- `historyFilter` 'ALL' | 'LATEST_ONLY'
- `parentTargetArn` string
- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListDeploymentsResponse
  - `deployments` Deployment[] — A list that summarizes each deployment.
    - `targetArn` string — The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">ARN</a> of the target IoT thing or thing group. When creating a subdeployment, the targetARN can only be a thing group.
    - `revisionId` string — The revision number of the deployment.
    - `deploymentId` string — The ID of the deployment.
    - `deploymentName` string — The name of the deployment.
    - `creationTimestamp` string, date-time — The time at which the deployment was created, expressed in ISO 8601 format.
    - `deploymentStatus` 'ACTIVE' | 'COMPLETED' | 'CANCELED' | 'FAILED' | 'INACTIVE' — The status of the deployment.
    - `isLatestForTarget` boolean — Whether or not the deployment is the latest revision for its target.
    - `parentTargetArn` string — The parent deployment's target <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">ARN</a> within a subdeployment.
  - `nextToken` string — The token for the next set of results, or null if there are no additional results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — InternalServerException
- `483` — ThrottlingException

---

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