---
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: 1119
product: InfluxDB OSS v1
version: v1
---

# v1.databases() function

-   Flux 0.16.0+
-   View 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/)