---
title: "Get referrers for a given digest"
method: GET
path: "/v2/{name}/referrers/{digest}"
---

# Get referrers for a given digest

`GET /v2/{name}/referrers/{digest}`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification/docs/v2/:name/referrers/:digest/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns referrers for a subject digest as an OCI image index. Missing repositories and
subjects with no referrers return 200 with an empty manifests list.

## Path parameters

- `name` string, required
- `digest` string, required

## Query parameters

- `artifactType` string

## Response `200`

OK

- ApiImageIndex
  - `annotations` object: Annotations contains arbitrary metadata for the image index.
  - `artifactType` string: ArtifactType specifies the IANA media type of artifact when the manifest is used for an artifact.
  - `manifests` V1Descriptor[]: Manifests references platform specific manifests.
    - `annotations` object: Annotations contains arbitrary metadata relating to the targeted content.
    - `artifactType` string: ArtifactType is the IANA media type of this artifact.
    - `data` integer[]: Data is an embedding of the targeted content. This is encoded as a base64 string when marshalled to JSON (automatically, by encoding/json). If present, Data can be used directly to avoid fetching the targeted content.
    - `digest` string: Digest is the digest of the targeted content.
    - `mediaType` string: MediaType is the media type of the object this schema refers to.
    - `platform` V1Platform
      - `architecture` string: Architecture field specifies the CPU architecture, for example `amd64` or `ppc64le`.
      - `os` string: OS specifies the operating system, for example `linux` or `windows`.
      - `os.features` string[]: OSFeatures is an optional field specifying an array of strings, each listing a required OS feature (for example on Windows `win32k`).
      - `os.version` string: OSVersion is an optional field specifying the operating system version, for example on Windows `10.0.14393.1066`.
      - `variant` string: Variant is an optional field specifying a variant of the CPU, for example `v7` to specify ARMv7 when architecture is `arm`.
    - `size` integer: Size specifies the size in bytes of the blob.
    - `urls` string[]: URLs specifies a list of URLs from which this object MAY be downloaded
  - `mediaType` string: MediaType specifies the type of this document data structure e.g. `application/vnd.oci.image.index.v1+json`
  - `schemaVersion` integer: SchemaVersion is the image manifest schema that this image follows
  - `subject` V1Descriptor
    - `annotations` object: Annotations contains arbitrary metadata relating to the targeted content.
    - `artifactType` string: ArtifactType is the IANA media type of this artifact.
    - `data` integer[]: Data is an embedding of the targeted content. This is encoded as a base64 string when marshalled to JSON (automatically, by encoding/json). If present, Data can be used directly to avoid fetching the targeted content.
    - `digest` string: Digest is the digest of the targeted content.
    - `mediaType` string: MediaType is the media type of the object this schema refers to.
    - `platform` V1Platform
      - `architecture` string: Architecture field specifies the CPU architecture, for example `amd64` or `ppc64le`.
      - `os` string: OS specifies the operating system, for example `linux` or `windows`.
      - `os.features` string[]: OSFeatures is an optional field specifying an array of strings, each listing a required OS feature (for example on Windows `win32k`).
      - `os.version` string: OSVersion is an optional field specifying the operating system version, for example on Windows `10.0.14393.1066`.
      - `variant` string: Variant is an optional field specifying a variant of the CPU, for example `v7` to specify ARMv7 when architecture is `arm`.
    - `size` integer: Size specifies the size in bytes of the blob.
    - `urls` string[]: URLs specifies a list of URLs from which this object MAY be downloaded

## Other responses

- `400`: bad request (invalid digest)
- `404`: not found (manifest unknown)
- `500`: internal server error
- `503`: storage temporarily unavailable

## Changes

- **2026-10-05** `fba44d54755f`: 1 info
  - added the non-success response with the status `503`
- **2026-06-26** `62d5df709bf8`: 1 info
  - added the non-success response with the status `400`
- **2023-06-12** `0e26d01895f9`: 1 info
  - endpoint added
- **2021-10-21** `81b68c5e4fde`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification/changes/v2/:name/referrers/:digest/get.md)

---

[API](https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification.md) - [All operations](https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification/revisions/7937343ee83f?raw)