---
title: "GET /otaUpdates"
method: GET
path: "/otaUpdates"
---

# GET /otaUpdates

`GET /otaUpdates`

Lists OTA updates.

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

## Query parameters

- `maxResults` integer
- `nextToken` string
- `otaUpdateStatus` 'CREATE_PENDING' | 'CREATE_IN_PROGRESS' | 'CREATE_COMPLETE' | 'CREATE_FAILED' | 'DELETE_IN_PROGRESS' | 'DELETE_FAILED'

## Response `200`

Success

- ListOTAUpdatesResponse
  - `otaUpdates` OTAUpdateSummary[] — A list of OTA update jobs.
    - `otaUpdateId` string — The OTA update ID.
    - `otaUpdateArn` string — The OTA update ARN.
    - `creationDate` string, date-time — The date when the OTA update was created.
  - `nextToken` string — A token to use to get the next set of results.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — UnauthorizedException
- `483` — InternalFailureException
- `484` — ServiceUnavailableException

---

[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)