---
title: "List repository images"
method: GET
path: "/v1/vcr/repository/{idOrName}/images"
tags: ["vcr"]
---

# List repository images

`GET /v1/vcr/repository/{idOrName}/images`

List images for a container registry repository, including their tags.

## Path parameters

- `idOrName` string, required

## Query parameters

- `projectId` string, required
- `limit` integer
- `cursor` string — Opaque pagination cursor returned by a previous list response.
- `untagged` boolean
- `teamId` string
- `slug` string

## Response `200`

- VcrImageList — A paginated list of images for a repository.
  - `images` VcrImageListItem[], required
    - `status` 'preparing' | 'ready' | 'unoptimized' | 'null', nullable, required — VHS-readiness status, or `null` for a multi-platform index.
    - `tags` string[], required — Tags pointing at this image's manifest.
    - `id` string, required — Internal identifier of the image.
    - `repositoryId` string, required — Identifier of the repository the image belongs to.
    - `manifestDigest` string, required — SHA-256 digest of the image manifest.
    - `kind` 'attestation' | 'index' | 'manifest', required — Whether the manifest is a multi-platform image index, a single-platform image manifest or an attestation.
    - `platform` string — Operating system the manifest targets. Only present for single-platform manifests.
    - `arch` string — CPU architecture the manifest targets. Only present for single-platform manifests.
    - `pushedBy` string — Identifier of the actor that pushed the image.
    - `sizeInBytes` number, required — Total size in bytes of the image's resources (manifest, config and layer blobs) stored by the registry.
    - `vhs` object — Converted VHS drive data, present once an image has been optimized for sandbox launch.
      - `path` string, required
      - `digest` string, required
      - `config` object — Optional VHS drive configuration captured for an optimized image.
        - `command` string[]
        - `entrypoint` string[]
        - `workingDir` string
    - `createdAt` string, required — ISO 8601 timestamp of when the image was created.
  - `nextCursor` string — Cursor to fetch the next page of results, when more are available.

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/b4d86a3e3479/schema)