---
title: v1.databases() function
description: v1.databases() returns a list of databases in an InfluxDB 1.x (1.7+) instance.
url: https://docs.influxdata.com/flux/v0/stdlib/influxdata/influxdb/v1/databases/
estimated_tokens: 345
product: InfluxDB OSS v1
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/influxdata/influxdb/v1/databases/
date: '2024-04-08T16:01:02-06:00'
lastmod: '2024-04-08T16:01:02-06:00'
---

* Flux 0.16.0+

InfluxDB support

`v1.databases()` returns a list of databases in an InfluxDB 1.x (1.7+) instance.

Output includes the following columns:

* **databaseName**: Database name (string)
* **retentionPolicy**: Retention policy name (string)
* **retentionPeriod**: Retention period in nanoseconds (integer)
* **default**: Default retention policy for the database (boolean)

##### Function type signature

```js
(
    ?host: string,
    ?org: string,
    ?orgID: string,
    ?token: string,
) => stream[{
    retentionPolicy: string,
    retentionPeriod: int,
    organizationID: string,
    default: bool,
    databaseName: string,
    bucketID: string,
}]
```

For more information, see [Function type signatures](/flux/v0/function-type-signatures/).

## Parameters

### org

Organization name.

### orgID

Organization ID.

### host

InfluxDB URL. Default is `http://localhost:8086`.

### token

InfluxDB API token.

## Examples

### List databases from an InfluxDB instance

```js
import "influxdata/influxdb/v1"

v1.databases()
```

#### Not supported in the Flux REPL

`v1` functions can retrieve schema information when executed within
the context of InfluxDB, but not from the [Flux REPL](/influxdb/cloud/tools/repl/).

#### Related

* [SHOW DATABASES in InfluxQL](/influxdb/v1/query_language/explore-schema#show-databases)

[metadata](/flux/v0/tags/metadata/)