---
title: "GET /2025-09-09/microvm-images/{imageIdentifier}/versions/{imageVersion}/builds"
method: GET
path: "/2025-09-09/microvm-images/{imageIdentifier}/versions/{imageVersion}/builds"
---

# GET /2025-09-09/microvm-images/{imageIdentifier}/versions/{imageVersion}/builds

`GET /2025-09-09/microvm-images/{imageIdentifier}/versions/{imageVersion}/builds`

Lists builds for a MicroVM image version with optional filtering by architecture and chipset. We recommend using pagination to ensure that the operation returns quickly and successfully.

## Path parameters

- `imageIdentifier` string, required — The ARN or ID of the MicroVmImage
- `imageVersion` string, required — A string which is not empty or blank (only whitespace).

## Query parameters

- `maxResults` integer
- `nextToken` string
- `architecture` 'ARM_64'
- `chipset` 'GRAVITON'
- `chipsetGeneration` string — A string which is not empty or blank (only whitespace).

## Response `200`

Success

- ListMicrovmImageBuildsOutput
  - `nextToken` string — The pagination token to use in a subsequent request to retrieve the next page of results. This value is null when there are no more results to return.
  - `items` MicrovmImageBuildSummary[], required — The list of MicroVM image builds.
    - `imageArn` string, required — The ARN of the MicroVM image.
    - `imageVersion` string, required — The version of the MicroVM image.
    - `buildId` string, required — The build request ID.
    - `buildState` 'PENDING' | 'IN_PROGRESS' | 'SUCCESSFUL' | 'FAILED', required — The current state of the build.
    - `architecture` 'ARM_64', required — The target CPU architecture for the build. Supported value: ARM_64.
    - `chipset` 'GRAVITON', required — The target chipset for the build.
    - `chipsetGeneration` string, required — The target chipset generation for the build.
    - `stateReason` string — The reason for the build state, if applicable.
    - `createdAt` string, date-time, required — The timestamp when the build was created.

## Other responses

- `480` — InternalServerException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/lambda-microvms.md) · [All operations](https://skmtc.net/aws/apis/lambda-microvms/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/lambda-microvms/versions/83f10af82eb8/schema)