---
title: Retrieve
url: https://docs.vultr.com/products/orchestration/container-registry/robot/retrieve
description: Retrieves information about a specific resource from your Vultr account.
publish_date: 2025-03-20T16:25:17.722248Z
last_updated: 2026-05-26T20:19:29.802890Z
---

# How to Retrieve a Robot Account Details from Vultr Container Registry

A robot account in the Vultr Container Registry is an automatically generated account designed for automated interactions with repositories. These accounts operate within a defined namespace and come with pre-configured permissions, such as pulling images from repositories. They are commonly used in CI/CD pipelines, automation scripts, and containerized deployments, ensuring secure, non-interactive access without exposing user credentials.

Follow this guide to retrieve robot account details from your container registry 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 Robots** endpoint](https://www.vultr.com/api/#tag/Container-Registry/operation/list-registry-robots) to list all the available robots and note the target robot's name.

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

    > [!NOTE]
    > Robot account names contain special characters like `$` and `+`, which must be URL-encoded before making API requests to prevent errors. You can either manually replace `$` with `%24` and `+` with `%2B` in the endpoint or export the robot name as a variable, avoiding the need for manual encoding.

1. Send a `GET` request to the [**Read Robot** endpoint](https://www.vultr.com/api/#tag/Container-Registry/paths/~1registry~1%7Bregistry-id%7D~1robot~1%7Brobot-name%7D/get) to retrieve the target robot details.

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