---
title: "GET /deviceUpdate/{instanceId}/updates"
method: GET
path: "/deviceUpdate/{instanceId}/updates"
tags: ["Update management"]
---

# GET /deviceUpdate/{instanceId}/updates

`GET /deviceUpdate/{instanceId}/updates`

Get a list of all updates that have been imported to Device Update for IoT Hub.

## Path parameters

- `instanceId` string, required

## Query parameters

- `api-version` string, required
- `search` string
- `filter` string

## Response `200`

The request has succeeded.

- UpdateList — The list of updates.
  - `value` Update[], required — The Update items on this page
    - `updateId` UpdateId, required — Update identifier.
      - `provider` string, required — Update provider.
      - `name` string, required — Update name.
      - `version` string, required — Update version.
    - `description` string — Update description specified by creator.
    - `friendlyName` string — Friendly update name specified by importer.
    - `isDeployable` boolean — Whether the update can be deployed to a device on its own.
    - `updateType` string — Update type. Deprecated in latest import manifest schema.
    - `installedCriteria` string — String interpreted by Device Update client to determine if the update is installed on the device. Deprecated in latest import manifest schema.
    - `compatibility` Compatibility[], required — List of update compatibility information.
    - `instructions` Instructions — Update install instructions container.
      - `steps` Step[], required — Collection of installation steps.
        - `type` 'inline' | 'reference' — Step type.
        - `description` string — Step description.
        - `handler` string — Identity of handler that will execute this step. Required if step type is inline.
        - `handlerProperties` object — Parameters to be passed to handler during execution.
        - `files` string[] — Collection of file names to be passed to handler during execution. Required if step type is inline.
        - `updateId` UpdateId — Update identifier.
          - `provider` string, required — Update provider.
          - `name` string, required — Update name.
          - `version` string, required — Update version.
    - `referencedBy` UpdateId[] — List of update identities that reference this update.
      - `provider` string, required — Update provider.
      - `name` string, required — Update name.
      - `version` string, required — Update version.
    - `scanResult` string — Update aggregate scan result (calculated from payload file scan results).
    - `manifestVersion` string, required — Schema version of manifest used to import the update.
    - `importedDateTime` string, date-time, required — Date and time in UTC when the update was imported.
    - `createdDateTime` string, date-time, required — Date and time in UTC when the update was created.
    - `etag` string — Update ETag.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

---

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