---
title: How to List All Clusters
url: https://docs.vultr.com/products/compute/clusters/how-to-list-all-clusters
description: Retrieve all cluster subscriptions associated with your Vultr account using the API with cursor-based pagination support for large result sets.
publish_date: 2026-04-17T14:09:02.998946Z
last_updated: 2026-04-23T16:40:48.630742Z
---

Listing clusters retrieves all cluster subscriptions associated with your account, including their status, region, attached instance count, and configuration details. The endpoint supports cursor-based pagination for accounts with many clusters.

This guide explains how to list all clusters using the Vultr API.

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}"
```

The response contains all clusters with their details. Use the `cursor` and `per_page` query parameters to paginate through large result sets.