---
title: "List Images"
method: GET
path: "/v1/vms/images"
tags: ["VMs"]
---

# List Images

`GET /v1/vms/images`

List all VM Images for the authenticated account

## Response `200`

List of images

- VmorchListImagesResponse — Response body for listing images
  - `object` 'list', required
  - `data` VmorchImageInfo[], required
    - `object` 'image', required
    - `image_id` string, required — The image ID
    - `name` string, required — Client given name of the image. Must be unique per account.
    - `upload_status` string, required — Upload status of the image
    - `sha256_hash` string, nullable — SHA256 hash of the image file for integrity verification
    - `created_at` integer, required — Creation timestamp as Unix timestamp in seconds
  - `has_more` boolean, required

## Other responses

- `403` — Node API features not enabled

## Changes

- **2026-02-17** `ad9dff266598` — 5 breaking, 1 warning, 8 info
  - the `data/items/name` response property's maxLength was unset from `255` for the response status `200`
  - the `data/items/sha256_hash` response property's maxLength was unset from `64` for the response status `200`
  - the `data/items/name` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `data/items/sha256_hash` response property's minLength was decreased from `64` to `0` for the response status `200`
  - …10 more
- **2026-02-17** `48ff5f0fb9ee` — 2 breaking, 4 warning, 4 info
  - the response property `data/items/object` became optional for the status `200`
  - removed the required property `data/items/image_id` from the response with the `200` status
  - added the new `completed` enum value to the `data/items/upload_status` response property for the response status `200`
  - added the new `failed` enum value to the `data/items/upload_status` response property for the response status `200`
  - …6 more
- …earlier changes not shown

[Full history](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/changes/v1/vms/images/get.md)

---

[API](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/revisions/e799cec0ecec?raw)