Sign in

v1

latestOpenAPI 3.0.02026-07-14285059.6 KB
images

Get details of repository's images

Gets details on the images in a repository.

get/v2/namespaces/{namespace}/repositories/{repository}/images

Path parameters

namespacestring required

Namespace of the repository.

repositorystring required

Name of the repository.

Query parameters

status'active' | 'inactive'

Filters to only show images of this status.

currently_taggedboolean

Filters to only show images with:

  • true: at least 1 current tag.
  • false: no current tags.
ordering'last_activity' | '-last_activity' | 'digest' | '-digest'

Orders the results by this property.

Prefixing with - sorts by descending order.

active_fromstring

Sets the time from which an image must have been pushed or pulled to be counted as active.

Defaults to 1 month before the current time.

pageinteger

Page number to get. Defaults to 1.

page_sizeinteger

Number of images to get per page. Defaults to 10. Max of 100.

Response

Success

countinteger

Total count of images in the repository.

nextstring nullable

Link to the next page with the same query parameters if there are more images.

previousstring nullable

Link to the previous page with the same query parameters if not on first page.

Example response

{
  "count": 100,
  "next": "https://hub.docker.com/v2/namespaces/mynamespace/repositories/myrepo/images?&page=4&page_size=20",
  "previous": "https://hub.docker.com/v2/namespaces/mynamespace/repositories/myrepo/images?&page=2&page_size=20",
  "results": [
    {
      "digest": "sha256:1234567890abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqr",
      "last_pulled": "2021-02-24T23:16:10.200008Z",
      "last_pushed": "2021-02-24T22:05:27.526308Z",
      "namespace": "mynamespace",
      "repository": "myrepo",
      "status": "active",
      "tags": [
        {
          "is_current": true,
          "tag": "latest"
        }
      ]
    }
  ]
}