---
title: List databases
description: Use the influxctl database list command to list databases in your InfluxDB cluster.
url: https://docs.influxdata.com/influxdb3/clustered/admin/databases/list/
estimated_tokens: 549
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/admin/databases/list/
date: '2026-05-01T17:29:03-05:00'
lastmod: '2026-05-01T17:29:03-05:00'
---

Use the [`influxctl database list` command](/influxdb3/clustered/reference/cli/influxctl/database/list/)to list databases in your InfluxDB cluster.

1. If you haven’t already, [download and install the `influxctl` CLI](/influxdb3/clustered/reference/cli/influxctl/#download-and-install-influxctl).

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

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

```sh
influxctl database list --format table
```

### Output formats

The `influxctl database list` command supports two output formats: `table` and `json`.
By default, the command outputs the list of databases formatted as a table.
For easier programmatic access to the command output, include `--format json`with your command to format the database list as JSON.

#### Example output

#### table ####

```sh
+---------------+------------------+------------+-----------------------+
| DATABASE NAME | RETENTION PERIOD | MAX TABLES | MAX COLUMNS PER TABLE |
+---------------+------------------+------------+-----------------------+
| mydb1         | infinite         |        500 |                   250 |
| mydb2         | infinite         |        500 |                   200 |
| mydb3         | 24h              |        100 |                   200 |
+---------------+------------------+------------+-----------------------+
```

```json
[
  {
    "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
    "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
    "database_name": "mydb1",
    "retention_period_ns": 0,
    "max_tables": 500,
    "max_columns_per_table": 250
  },
  {
    "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
    "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
    "database_name": "mydb2",
    "retention_period_ns": 0,
    "max_tables": 500,
    "max_columns_per_table": 200
  },
  {
    "account_id": "0x0x0x00-0Xx0-00x0-x0X0-00x00XX0Xx0X",
    "cluster_id": "X0x0xxx0-0XXx-000x-00x0-0X000Xx00000",
    "database_name": "mydb3",
    "retention_period_ns": 86400000000000,
    "max_tables": 100,
    "max_columns_per_table": 200
  }
]
```

#### Related

* [influxctl database list](/influxdb3/clustered/reference/cli/influxctl/database/list/)