Check if manifest exists Run in API Explorer

HEAD /v2/{name}/manifests/{reference}

Use this endpoint to verify whether a manifest exists by tag or digest.

This is a lightweight operation that returns only headers (no body). It is useful for:

  • Checking for the existence of a specific image version
  • Determining the digest or size of a manifest before downloading or deleting

This endpoint requires authentication with pull scope.

Headers

  • Authorization string Required

    Bearer token for authentication

  • Accept string

    Media type of the manifest to check. The response will match one of the accepted types.

Path parameters

  • name string Required

    Name of the Repository

  • reference string Required

    Tag or digest to check

Responses

  • 200

    Manifest exists.

    Hide headers attributes Show headers attributes
    • Content-Length integer

      Size of the manifest in bytes

    • Docker-Content-Digest string

      Digest of the manifest

    • Content-Type string

      Media type of the manifest

  • 404

    Manifest not found.

  • 401

    Authentication required.

  • 403

    Access denied.

  • 429

    Too many requests.

HEAD /v2/{name}/manifests/{reference} 
# HEAD /v2/{name}/manifests/{reference}
curl -I \
  -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 HEAD 'https://registry-1.docker.io/v2/library/ubuntu/manifests/latest' \
 --header "Authorization: string" \
 --header "Accept: application/vnd.docker.distribution.manifest.v2+json"