---
title: from() function
description: from() retrieves data from an InfluxDB bucket between the start and stop times.
url: https://docs.influxdata.com/flux/v0/stdlib/contrib/jsternberg/influxdb/from/
estimated_tokens: 630
product: Flux
version: v0
publisher: InfluxData
canonical: https://docs.influxdata.com/flux/v0/stdlib/contrib/jsternberg/influxdb/from/
date: '2025-02-27T17:50:16-06:00'
lastmod: '2025-02-27T17:50:16-06:00'
---

* Flux 0.77.0+

InfluxDB support

> [!Important]
> `from()` is a user-contributed function maintained by
> the [package author](#package-author-and-maintainer).

`from()` retrieves data from an InfluxDB bucket between the `start` and `stop` times.

This version of `from` is equivalent to `from() |> range()` in a single call.

##### Function type signature

```js
(
    bucket: string,
    start: A,
    ?host: string,
    ?org: string,
    ?stop: B,
    ?token: string,
) => stream[{
    C with
    _value: D,
    _time: time,
    _stop: time,
    _start: time,
    _measurement: string,
    _field: string,
}]
```

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

## Parameters

### bucket

(Required)
Name of the bucket to query.

**InfluxDB 1.x or Enterprise**: Provide an empty string (`""`).

### start

(Required)
Earliest time to include in results.

Results include points that match the specified start time.
Use a relative duration, absolute time, or integer (Unix timestamp in seconds).
For example, `-1h`, `2019-08-28T22:00:00Z`, or `1567029600`.
Durations are relative to `now()`.

### stop

Latest time to include in results. Default is `now()`.

Results exclude points that match the specified stop time.
Use a relative duration, absolute time, or integer (Unix timestamp in seconds).
For example, `-1h`, `2019-08-28T22:00:00Z`, or `1567029600`.
Durations are relative to `now()`.

### host

URL of the InfluxDB instance to query.

See [InfluxDB OSS URLs](/influxdb/v2/reference/urls/)or [InfluxDB Cloud regions](/influxdb/cloud/reference/regions/).

### org

Organization name.

### token

InfluxDB [API token](/influxdb/v2/security/tokens/).

## Examples

* [Query using the bucket name](#query-using-the-bucket-name)
* [Query using the bucket ID](#query-using-the-bucket-id)
* [Query a remote InfluxDB Cloud instance](#query-a-remote-influxdb-cloud-instance)

### Query using the bucket name

```js
import "contrib/jsternberg/influxdb"

influxdb.from(bucket: "example-bucket")
```

### Query using the bucket ID

```js
import "contrib/jsternberg/influxdb"

influxdb.from(bucketID: "0261d8287f4d6000")
```

### Query a remote InfluxDB Cloud instance

```js
import "contrib/jsternberg/influxdb"
import "influxdata/influxdb/secrets"

token = secrets.get(key: "INFLUXDB_CLOUD_TOKEN")

from(
    bucket: "example-bucket",
    host: "https://us-west-2-1.aws.cloud2.influxdata.com",
    org: "example-org",
    token: token,
)
```

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