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

# How to Retrieve Artifact Details from Vultr Container Registry Repository

An artifact refers to a specific version of a container image stored within a repository in the Vultr Container Registry. It represents the packaged and deployable unit of the image, containing metadata such as its digest, tags, and associated push/pull times. By retrieving this data, you can gain insights into the artifact's version, usage patterns, and storage, helping you manage and optimize your container images more effectively.

Follow this guide to retrieve artifact details from the container registry repository on your Vultr account using the 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 [**List Artifacts** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-repository-artifacts) to list all the available artifacts and note the target artifact's digest.

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

1. Send a `GET` request to the [**Read Artifact** endpoint](https://www.vultr.com/api/#tag/Container-Registry/paths/~1registry~1{registry-id}~1repository~1{repository-image}~1artifact~1{artifact-digest}/get) to retrieve the target artifact's details.

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