---
title: Retrieve
url: https://docs.vultr.com/products/orchestration/container-registry/repository/retrieve
description: Retrieves information about a specific resource from the Vultr API.
publish_date: 2025-03-20T16:01:43.851747Z
last_updated: 2026-05-26T20:19:08.450421Z
---

# How to Retrieve Repository Details from Vultr Container Registry

A repository in the Vultr Container Registry stores container images pushed via OCI-compliant container engines like Docker or Podman. Each repository acts as a logical storage unit, organizing images under unique names for streamlined management and deployment. Retrieving repository details exposes metadata such as the repository name, description, and pull count, providing visibility into usage patterns and storage utilization.

Follow this guide to retrieve repository details from your container registry on your Vultr account using the Vultr Console, API or CLI.

=== "Vultr Console"

    1. Navigate to **Products** and click **Container Registry**.

    1. Click your target registry to open its management page.

    1. Click **Repositories** to view all the available repositories.

    1. Locate the target repository and retrieve its details, including the description, pull count, and artifact count.

=== "Vultr API"

    1. Send a `GET` request to the [**List Container Registries** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registries) and note the target registry's ID.

        ```console
        $ curl "https://api.vultr.com/v2/registries" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```

    1. Send a `GET` request to the [**List Repositories** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-repositories) to list all the available repositories and note the target repository image.

        ```console
        $ curl "https://api.vultr.com/v2/registry/{registry-id}/repositories" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```

    1. Send a `GET` request to the [**Read Repository** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/read-registry-repository) to retrieve details of the target repository.

        ```console
        $ curl "https://api.vultr.com/v2/registry/{registry-id}/repository/{repository-image}" \
            -X GET \
            -H "Authorization: Bearer ${VULTR_API_KEY}"
        ```

=== "Vultr CLI"

    1. List all the available registries in your Vultr account and note the target registry's ID.

        ```console
        $ vultr-cli container-registry list
        ```

    1. List all the available repositories in your registry and note the target repository image.

        ```console
        $ vultr-cli container-registry repository list <registry-id>
        ```

    1. Retrieve details of the target repository.

        ```console
        $ vultr-cli container-registry get <registry-id> --image-name "<repository-image>"
        ```