---
title: "Get a repository image"
method: GET
path: "/v1/vcr/repository/{idOrName}/images/{imageIdOrDigest}"
tags: ["vcr"]
---

# Get a repository image

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

Fetch an individual image from a repository, including its tags and Dockerfile history entries with discriminated layer details for UI rendering. The image may be addressed by its internal id (`image_...`) or by its manifest digest (`sha256:...`).

## Path parameters

- `idOrName` string, required
- `imageIdOrDigest` string, required — The internal image id (`image_...`) or the image manifest digest (`sha256:...`).

## Query parameters

- `projectId` string, required
- `teamId` string
- `slug` string

## Response `200`

- object
  - `image` VcrImageDetail, required — A single image with its tags, status and resolved Dockerfile layer history.
    - `layers` VcrImageLayer[], required
      - union
        - object
          - `createdBy` string, nullable, required
          - `digest` string, nullable, required
          - `operation` 'ADD' | 'ARG' | 'CMD' | 'COPY' | 'ENTRYPOINT' | 'ENV' | 'EXPOSE' | 'FROM' | 'HEALTHCHECK' | 'LABEL' | 'ONBUILD' | 'RUN' | 'SHELL' | 'STOPSIGNAL' | 'UNKNOWN' | 'USER' | 'VOLUME' | 'WORKDIR', required — Docker/OCI build instruction associated with an image layer.
          - `sizeBytes` number, nullable, required
          - `type` 'FROM', required
          - `baseImage` string, nullable, required
          - `collapsedDigests` string[], required
          - `collapsedLayerCount` number, required
        - object
          - `createdBy` string, nullable, required
          - `digest` string, nullable, required
          - `operation` 'ADD' | 'ARG' | 'CMD' | 'COPY' | 'ENTRYPOINT' | 'ENV' | 'EXPOSE' | 'FROM' | 'HEALTHCHECK' | 'LABEL' | 'ONBUILD' | 'RUN' | 'SHELL' | 'STOPSIGNAL' | 'UNKNOWN' | 'USER' | 'VOLUME' | 'WORKDIR', required — Docker/OCI build instruction associated with an image layer.
          - `sizeBytes` number, nullable, required
          - `type` 'RUN', required
          - `command` string, nullable, required
        - object
          - `createdBy` string, nullable, required
          - `digest` string, nullable, required
          - `operation` 'ADD' | 'ARG' | 'CMD' | 'COPY' | 'ENTRYPOINT' | 'ENV' | 'EXPOSE' | 'FROM' | 'HEALTHCHECK' | 'LABEL' | 'ONBUILD' | 'RUN' | 'SHELL' | 'STOPSIGNAL' | 'UNKNOWN' | 'USER' | 'VOLUME' | 'WORKDIR', required — Docker/OCI build instruction associated with an image layer.
          - `sizeBytes` number, nullable, required
          - `type` 'ENV', required
          - `env` string, nullable, required
        - object
          - `createdBy` string, nullable, required
          - `digest` string, nullable, required
          - `operation` 'ADD' | 'ARG' | 'CMD' | 'COPY' | 'ENTRYPOINT' | 'ENV' | 'EXPOSE' | 'FROM' | 'HEALTHCHECK' | 'LABEL' | 'ONBUILD' | 'RUN' | 'SHELL' | 'STOPSIGNAL' | 'UNKNOWN' | 'USER' | 'VOLUME' | 'WORKDIR', required — Docker/OCI build instruction associated with an image layer.
          - `sizeBytes` number, nullable, required
          - `type` 'ADD' | 'ARG' | 'CMD' | 'COPY' | 'ENTRYPOINT' | 'EXPOSE' | 'HEALTHCHECK' | 'LABEL' | 'ONBUILD' | 'SHELL' | 'STOPSIGNAL' | 'UNKNOWN' | 'USER' | 'VOLUME' | 'WORKDIR', required
          - `value` string, nullable, 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.

## 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/revisions/b4d86a3e3479/schema)