---
title: "GET /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}"
method: GET
path: "/deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}"
tags: ["Update management"]
---

# GET /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}

`GET /deviceUpdate/{instanceId}/updates/providers/{provider}/names/{name}/versions/{version}`

Get a specific update version.

## Path parameters

- `instanceId` string, required
- `provider` string, required
- `name` string, required
- `version` string, required

## Query parameters

- `api-version` string, required

## Headers

- `If-None-Match` string

## Response `200`

The request has succeeded.

- Update — Update metadata.
  - `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.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2020-09-01) `5ba53cf1b884` — 1 info
  - endpoint added
- **2026-07-13** (2020-09-01) `6f894985f81d` — 1 info
  - removed the non-success response with the status `304`
- **2021-03-02** (2020-09-01) `be0eed01a5b1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/azure/apis/deviceupdate-microsoft-deviceupdate/changes/deviceUpdate/:instanceId/updates/providers/:provider/names/:name/versions/:version/get.md)

---

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