---
title: "Lists all Virtual Machine Images supported by the Azure Batch service."
method: GET
path: "/supportedimages"
tags: ["Accounts"]
---

# Lists all Virtual Machine Images supported by the Azure Batch service.

`GET /supportedimages`

## Query parameters

- `$filter` string
- `maxresults` integer
- `timeout` integer
- `api-version` string, required

## Headers

- `client-request-id` string, uuid
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc1123

## Response `200`

A response containing the list of supported Virtual Machine Images.

- AccountListSupportedImagesResult
  - `value` ImageInformation[]
    - `nodeAgentSKUId` string, required
    - `imageReference` ImageReference, required
      - `publisher` string — For example, Canonical or MicrosoftWindowsServer.
      - `offer` string — For example, UbuntuServer or WindowsServer.
      - `sku` string — For example, 18.04-LTS or 2019-Datacenter.
      - `version` string — A value of 'latest' can be specified to select the latest version of an Image. If omitted, the default is 'latest'.
      - `virtualMachineImageId` string — This property is mutually exclusive with other ImageReference properties. The Azure Compute Gallery Image must have replicas in the same region and must be in the same subscription as the Azure Batch account. If the image version is not specified in the imageId, the latest version will be used. For information about the firewall settings for the Batch Compute Node agent to communicate with the Batch service see https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.
      - `exactVersion` string — The specific version of the platform image or marketplace image used to create the node. This read-only field differs from 'version' only if the value specified for 'version' when the pool was created was 'latest'.
      - `sharedGalleryImageId` string — This property is mutually exclusive with other properties and can be fetched from shared gallery image GET call.
      - `communityGalleryImageId` string — This property is mutually exclusive with other properties and can be fetched from community gallery image GET call.
    - `osType` 'linux' | 'windows', required
    - `capabilities` string[] — Not every capability of the Image is listed. Capabilities in this list are considered of special interest and are generally related to integration with other features in the Azure Batch service.
    - `batchSupportEndOfLife` string, date-time
    - `verificationType` 'verified' | 'unverified', required
  - `odata.nextLink` string

## Other responses

- `default` — The error from the Batch service.

## Changes

- **2026-07-13** `dddf0d52054a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/batch-batch/changes/supportedimages/get.md)

---

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