Get image manifest Run in API Explorer

GET /v2/{name}/manifests/{reference}

Fetch the manifest identified by name and reference, where reference can be a tag (e.g., latest) or a digest (e.g., sha256:...).

The manifest contains metadata about the image, including configuration and layer digests. It is required for pulling images from the registry.

This endpoint requires authentication. Use the Authorization: Bearer <token> header.

Headers

  • Authorization string Required

    RFC7235-compliant authorization header (e.g., Bearer <token>).

  • Accept string

    Media type(s) the client supports for the manifest.

    The registry supports the following media types:

    • application/vnd.docker.distribution.manifest.v2+json
    • application/vnd.docker.distribution.manifest.list.v2+json
    • application/vnd.oci.image.manifest.v1+json
    • application/vnd.oci.image.index.v1+json

Path parameters

  • name string Required

    Name of the target repository

  • reference string Required

    Tag or digest of the target manifest

Responses

  • 200 application/vnd.docker.distribution.manifest.v2+json

    Manifest fetched successfully.

    Hide headers attributes Show headers attributes
    • Docker-Content-Digest string

      Digest of the returned manifest content.

    • Content-Type string

      Media type of the returned manifest.

    Hide response attributes Show response attributes object
    • schemaVersion integer Required
    • mediaType string Required
    • config object Required
      Hide config attributes Show config attributes object
      • mediaType string
      • size integer
      • digest string
    • layers array[object] Required
      Hide layers attributes Show layers attributes object
      • mediaType string
      • size integer
      • digest string
  • 400

    Invalid name or reference.

  • 401

    Authentication required.

  • 403

    Access denied.

  • 404

    Repository or manifest not found.

  • 429

    Too many requests.

GET /v2/{name}/manifests/{reference} 
# GET a manifest (by tag or digest)
curl -H "Authorization: Bearer $TOKEN" \
     -H "Accept: application/vnd.docker.distribution.manifest.v2+json" \
     https://registry-1.docker.io/v2/library/ubuntu/manifests/latest

curl \
 --request GET 'https://registry-1.docker.io/v2/library/ubuntu/manifests/latest' \
 --header "Authorization: string" \
 --header "Accept: string"
Response examples (200) 
{
  "config": {
    "size": 7023,
    "digest": "sha256:123456abcdef...",
    "mediaType": "application/vnd.docker.container.image.v1+json"
  },
  "layers": [
    {
      "size": 32654,
      "digest": "sha256:abcdef123456...",
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip"
    },
    {
      "size": 16724,
      "digest": "sha256:7890abcdef12...",
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip"
    }
  ],
  "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
  "schemaVersion": 2
}