---
title: List clusters
description: Use the Admin UI or the influxctl cluster list command to view information about InfluxDB Cloud Dedicated clusters associated with your account ID.
url: https://docs.influxdata.com/influxdb3/cloud-dedicated/admin/clusters/list/
estimated_tokens: 653
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-dedicated/admin/clusters/list/
date: '2026-03-17T12:07:19-05:00'
lastmod: '2026-03-17T12:07:19-05:00'
---

Use the Admin UI or the [`influxctl cluster list` CLI command](/influxdb3/cloud-dedicated/reference/cli/influxctl/cluster/list/)to view information about all InfluxDB Cloud Dedicated clusters associated with your account ID.

#### Admin UI ####

Access the InfluxDB Cloud Dedicated Admin UI at [console.influxdata.com](https://console.influxdata.com).
If you don’t have login credentials, [contact InfluxData support](https://support.influxdata.com).

### View cluster details

The cluster list displays the following cluster details:

* Cluster ID and name
* Status (ready, provisioning, etc.)
* Size (standard or custom)
* URL endpoint

## Use the CLI

1. If you haven’t already, [download and install the `influxctl` CLI](/influxdb3/cloud-dedicated/reference/cli/influxctl/#download-and-install-influxctl), and then [configure a connection profile](/influxdb3/cloud-dedicated/reference/cli/influxctl/#configure-connection-profiles) for your cluster.

2. Run `influxctl cluster list` with the following:

   * *Optional*: [Output format](#output-formats)

   ```
   influxctl cluster list --format table
   ```

### Output formats

The `influxctl cluster list` command supports two output formats: `table` and `json`.
By default, the output is formatted as a table.

#### Example table

```sh
+--------------------------------------+------------------+-------+----------------------------------------------------+
| ID                                   | NAME             | STATE | URL                                                |
+--------------------------------------+------------------+-------+----------------------------------------------------+
| X0x0xxx0-0XXx-000x-00x0-0X000Xx00000 | Internal - Cluster 1 | ready | X0x0xxx0-0XXx-000x-00x0-0X000Xx00000.a.influxdb.io |
+--------------------------------------+------------------+-------+----------------------------------------------------+
```

#### Detailed output in JSON

For additional cluster details and easier programmatic access to the command output, include `--format json`with your command–for example:

```sh
influxctl cluster list --format json
```

The output is a JSON array of cluster objects that include additional fields such as account ID and created date.

```json
[
  {
    "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
    "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
    "name": "Internal - Cluster 1",
    "url": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000.a.influxdb.io",
    "state": "ready",
    "created_at": {
      "seconds": 1686670941,
      "nanos": 520023000
    },
    "category": 1
  }
]
```