Get blob upload status Run in API Explorer

GET /v2/{name}/blobs/uploads/{uuid}

Retrieve the current status of an in-progress blob upload.

This is useful for:

  • Resuming an interrupted upload
  • Determining how many bytes have been accepted so far
  • Retrying from the correct offset in chunked uploads

The response includes the Range header indicating the byte range received so far, and a Docker-Upload-UUID for identifying the session.

Headers

  • Authorization string Required

Path parameters

  • name string Required

    Repository Name

  • uuid string Required

    Upload session UUID

Responses

  • 204

    Upload in progress. No body is returned.

    Hide headers attributes Show headers attributes
    • Range string

      Current byte range uploaded (inclusive)

    • Docker-Upload-UUID string

      UUID of the upload session

    • Location string

      URL to continue or complete the upload

  • 401

    Authentication required

  • 403

    Access denied

  • 404

    Upload session not found

  • 429

    Too many requests

GET /v2/{name}/blobs/uploads/{uuid} 
# GET upload status
curl -I \
  -H "Authorization: Bearer $TOKEN" \
  https://registry-1.docker.io/v2/library/ubuntu/blobs/uploads/abc123

curl \
 --request GET 'https://registry-1.docker.io/v2/library/ubuntu/blobs/uploads/abc123' \
 --header "Authorization: Bearer eyJhbGciOi..."