Give Feedback

pydo.registries.list_repositories_v2()

Generated on 7 Jul 2026 from pydo version v0.39.0

Copy page as Markdown View page as Markdown

Usage

client.registries.list_repositories_v2(
    per_page=20,
    page=1,
    page_token=None,
    registry_name="example",
)

Returns JSONRaises HttpResponseError

Description

To list all repositories in your container registry, send a GET request to /v2/registries/{registry_name}/repositoriesV2. It is similar to GET /v2/registry/{registry_name}/repositoriesV2.

Parameters

per_page integer optional

Number of items returned per page

Min: 1

Max: 200

Default: 20

page integer optional

Which 'page' of paginated results to return. Ignored when 'page_token' is provided.

Min: 1

Default: 1

page_token string optional

Token to retrieve of the next or previous set of results more quickly than using 'page'.

registry_name string required

The name of a container registry.

Request Sample

Show Request Sample

import os
from pydo import Client

client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))

resp = client.registries.list_repositories_v2(registry_name="example")

Pagination

This method returns paginated results. The response includes a links.pages object with URLs for navigating between pages. To retrieve the next page, parse the next URL and pass the page parameter:

from urllib.parse import urlparse, parse_qs

resp = client.registries.list_repositories_v2(registry_name="example", )
pages = resp.get("links", {}).get("pages", {})

while "next" in pages:
    parsed = urlparse(pages["next"])
    page = int(parse_qs(parsed.query)["page"][0])
    resp = client.registries.list_repositories_v2(registry_name="example", page=page)
    pages = resp.get("links", {}).get("pages", {})

Response Example

Show Response Example

{
  "repositories": [
    {
      "registry_name": "example",
      "name": "repo-1",
      "tag_count": 57,
      "manifest_count": 82,
      "latest_manifest": {
        "digest": "sha256:cb8a924afdf0229ef7515d9e5b3024e23b3eb03ddbba287f4a19c6ac90b8d221",
        "registry_name": "example",
        "repository": "repo-1",
        "compressed_size_bytes": 1972332,
        "size_bytes": 2816445,
        "updated_at": "2021-04-09T23:54:25Z",
        "tags": [
          "v1",
          "v2"
        ],
        "blobs": [
          {
            "digest": "sha256:14119a10abf4669e8cdbdff324a9f9605d99697215a0d21c360fe8dfa8471bab",
            "compressed_size_bytes": 1471
          },
          {
            "digest": "sha256:a0d0a0d46f8b52473982a3c466318f479767577551a53ffc9074c9fa7035982e",
            "compressed_size_byte": 2814446
          },
          {
            "digest": "sha256:69704ef328d05a9f806b6b8502915e6a0a4faa4d72018dc42343f511490daf8a",
            "compressed_size_bytes": 528
          }
        ]
      }
    }
  ],
  "meta": {
    "total": 5
  },
  "links": {
    "pages": {
      "next": "https://api.digitalocean.com/v2/registry/example/repositoriesV2?page=2&page_token=JPZmZzZXQiOjB9&per_page=1",
      "last": "https://api.digitalocean.com/v2/registry/example/repositoriesV2?page=5&per_page=1"
    }
  }
}

More Information

See /v2/registries/{registry_name}/repositoriesV2 in the API reference for additional detail on responses, headers, parameters, and more.