---
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}`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/vcr/repository/{idOrName}/images/{imageIdOrDigest}`
- Auth: HTTP bearer

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: Project ID or name (slug) within the authenticated team. IDs take precedence over names. Missing or empty values return HTTP 400.
- `teamId` string
- `slug` string

## Response `200`

- object
  - `image` VcrImageDetail, required: A single image with its tags, status and resolved Dockerfile layer history.
    - `arch` string: CPU architecture the manifest targets. Only present for single-platform manifests.
    - `createdAt` string, required: ISO 8601 timestamp of when the image was created.
    - `id` string, required: Internal identifier of the image.
    - `kind` 'attestation' | 'index' | 'manifest', required: Whether the manifest is a multi-platform image index, a single-platform image manifest or an attestation.
    - `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
          - `baseImage` string, nullable, required
          - `collapsedDigests` string[], required
          - `collapsedLayerCount` number, required
          - `type` 'FROM', 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
          - `command` string, nullable, required
          - `type` 'RUN', 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
          - `env` string, nullable, required
          - `type` 'ENV', 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
    - `manifestDigest` string, required: SHA-256 digest of the image manifest.
    - `platform` string: Operating system the manifest targets. Only present for single-platform manifests.
    - `pushedBy` string: Identifier of the actor that pushed the image.
    - `repositoryId` string, required: Identifier of the repository the image belongs to.
    - `sizeInBytes` number, required: Total size in bytes of the image's resources (manifest, config and layer blobs) stored by the registry.
    - `status` 'errored' | '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.

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

## Changes

- **2026-09-23** `c8d11c5d2271`: 1 warning
  - added the new `errored` enum value to the `image/status` response property for the response status `200`
- **2026-08-20** `b4b4b597ab64`: 1 warning
  - removed the optional property `image/vhs` from the response with the `200` status

[Operation history](https://skmtc.dev/vercel/apis/vercel-api/changes/v1/vcr/repository/:idOrName/images/:imageIdOrDigest/get.md)

---

[API](https://skmtc.dev/vercel/apis/vercel-api.md) - [All operations](https://skmtc.dev/vercel/apis/vercel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/vercel-api/revisions/60686c0e1f6a?raw)