---
title: "GET /2025-09-09/microvms"
method: GET
path: "/2025-09-09/microvms"
---

# GET /2025-09-09/microvms

`GET /2025-09-09/microvms`

Lists MicroVMs in the account with optional filtering by image and version. We recommend using pagination to ensure that the operation returns quickly and successfully.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `imageIdentifier` string — The ARN or ID of the MicroVmImage
- `imageVersion` string

## Response `200`

Success

- ListMicrovmsResponse
  - `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` MicrovmItem[], required — The list of MicroVMs.
    - `microvmId` string, required — The unique identifier of the MicroVM.
    - `state` 'PENDING' | 'RUNNING' | 'SUSPENDING' | 'SUSPENDED' | 'TERMINATING' | 'TERMINATED', required — The current lifecycle state of the MicroVM.
    - `imageArn` string, required — The ARN of the MicroVM image used to run this MicroVM.
    - `imageVersion` string, required — The version of the MicroVM image used to run this MicroVM.
    - `startedAt` string, date-time, required — The timestamp when the MicroVM started.

## 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)