---
title: influxctl database list
description: The influxctl database list command lists all databases in an InfluxDB cluster.
url: https://docs.influxdata.com/influxdb3/clustered/reference/cli/influxctl/database/list/
estimated_tokens: 304
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/reference/cli/influxctl/database/list/
date: '2025-06-30T15:05:37-06:00'
lastmod: '2025-06-30T15:05:37-06:00'
---

The `influxctl database list` command lists all databases in an InfluxDB
cluster.

The `--format` flag lets you print the output in other formats.
The `json` format is available for programmatic parsing by other tooling.
Default: `table`.

## Usage

```sh
influxctl database list [--format=table|json]
```

## Flags

|Flag|                 |                                 Description                                  |
|----|-----------------|------------------------------------------------------------------------------|
|    |`--filter-status`|Only list databases with a specific status (`active` *(default)* or `deleted`)|
|    |   `--format`    |                Output format (`table` *(default)* or `json`)                 |
|`-h`|    `--help`     |                             Output command help                              |

*Also see [`influxctl` global flags](/influxdb3/clustered/reference/cli/influxctl/#global-flags).*
| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
|  | --filter-status | Only list databases with a specific status ( active   (default)  or  deleted ) |
|  | --format | Output format ( table   (default)  or  json ) |
| -h | --help | Output command help |