---
title: How to Retrieve a Cluster
url: https://docs.vultr.com/products/compute/clusters/how-to-retrieve-a-cluster
description: Retrieve full details of a Vultr cluster including its label, region, type, pool configuration, attached instances, and current status via the API.
publish_date: 2026-04-17T14:09:13.414025Z
last_updated: 2026-04-23T16:41:26.605639Z
---

Retrieving a cluster returns its full details including the label, region, type, pool configuration, attached instances, instance template, and current status. This is useful for checking cluster health, reviewing configuration, and obtaining instance IDs for management operations.

This guide explains how to retrieve a cluster using the Vultr API.

1. Send a `GET` request to the [**List Clusters** endpoint](https://www.vultr.com/api/#tag/clusters/operation/list-clusters) to retrieve all clusters.

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

    Note the `id` of the cluster you want to retrieve.

1. Send a `GET` request to the [**Get Cluster** endpoint](https://www.vultr.com/api/#tag/clusters/operation/get-cluster) to retrieve the cluster details. Replace `{cluster-id}` with the id of the cluster.

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

    The response contains the cluster details including attached instances and current status.