---
title: "GET /v1/projects/{projectsId}/locations/{locationsId}/imageVersions"
method: GET
path: "/v1/projects/{projectsId}/locations/{locationsId}/imageVersions"
tags: ["projects"]
---

# GET /v1/projects/{projectsId}/locations/{locationsId}/imageVersions

`GET /v1/projects/{projectsId}/locations/{locationsId}/imageVersions`

## Request

- Base URL: `https://composer.googleapis.com`
- URL: `https://composer.googleapis.com/v1/projects/{projectsId}/locations/{locationsId}/imageVersions`
- Auth: one of:
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloud-platform`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloud-platform`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloudcomposer`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloudcomposer`
  - OAuth 2 and OAuth 2
    - Implicit: `https://accounts.google.com/o/oauth2/auth`
    - Scopes: `https://www.googleapis.com/auth/cloudcomposer.readonly`
    - Authorization code: `https://accounts.google.com/o/oauth2/auth`
    - Token URL: `https://accounts.google.com/o/oauth2/token` scopes: `https://www.googleapis.com/auth/cloudcomposer.readonly`
- TypeScript: <https://skmtc.dev/google/apis/composer/docs/v1/projects/:projectsId/locations/:locationsId/imageVersions/get.ts> (a function with typed inputs; its response is checked against the schema)

List ImageVersions for provided location.

## Path parameters

- `projectsId` string, required
- `locationsId` string, required

## Query parameters

- `includePastReleases` boolean
- `pageSize` integer
- `pageToken` string

## Response `200`

Successful response

- ListImageVersionsResponse: The ImageVersions in a project and location.
  - `imageVersions` ImageVersion[]: The list of supported ImageVersions in a location.
    - `creationDisabled` boolean: Whether it is impossible to create an environment with the image version.
    - `devModeSupported` boolean: Whether it is possible to create an environment in the `DEVELOPMENT` mode with the image version.
    - `imageVersionId` string: The string identifier of the ImageVersion, in the form: "composer-x.y.z-airflow-a.b.c"
    - `isDefault` boolean: Whether this is the default ImageVersion used by Composer during environment creation if no input ImageVersion is specified.
    - `releaseDate` Date: Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp
      - `day` integer: Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
      - `month` integer: Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
      - `year` integer: Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
    - `supportedPythonVersions` string[]: supported python versions
    - `upgradeDisabled` boolean: Whether it is impossible to upgrade an environment running with the image version.
  - `nextPageToken` string: The page token used to query for the next page if one exists.

## Changes

- **2026-11-07** `9c23b974ddbb`: 4 info
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloud-platform` was added to the endpoint's security scheme `Oauth2c`
  - the security scope `https://www.googleapis.com/auth/cloudcomposer.readonly` was removed from the endpoint's security scheme `Oauth2`
  - the security scope `https://www.googleapis.com/auth/cloudcomposer.readonly` was removed from the endpoint's security scheme `Oauth2c`

[Operation history](https://skmtc.dev/google/apis/composer/changes/v1/projects/:projectsId/locations/:locationsId/imageVersions/get.md)

---

[API](https://skmtc.dev/google/apis/composer.md) - [All operations](https://skmtc.dev/google/apis/composer/llms.txt) - [OpenAPI document](https://skmtc.dev/google/apis/composer/revisions/9c23b974ddbb?raw)