--- title: "Get image blob/layer" method: GET path: "/v2/{name}/blobs/{digest}" --- # Get image blob/layer `GET /v2/{name}/blobs/{digest}` ## Request - The document declares no server URL. - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Get an image's blob/layer given a digest ## Path parameters - `name` string, required - `digest` string, required ## Response `200` OK - ApiImageManifest - `annotations` object: Annotations contains arbitrary metadata for the image manifest. - `artifactType` string: ArtifactType specifies the IANA media type of artifact when the manifest is used for an artifact. - `config` 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 - `layers` V1Descriptor[]: Layers is an indexed list of layers referenced by the manifest. - `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.manifest.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 - `404`: not found - `500`: internal server error - `503`: storage temporarily unavailable ## Changes - **2026-10-05** `fba44d54755f`: 4 info - added the non-success response with the status `400` - added the non-success response with the status `404` - added the non-success response with the status `500` - added the non-success response with the status `503` [Operation history](https://skmtc.dev/project-zot/apis/open-container-initiative-distribution-specification/changes/v2/:name/blobs/: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)