Skip to main content
POST
Export time series to downloadable files

Authorizations

Authorization
string
header
required

Use an Observe API key from the management console. The key selects the project and must grant the permission listed on the operation. Keep this key on your server.

Body

application/json
fromDate
string
required

Range start in UTC, formatted as YYYY-MM-DDTHH:MM:SS without a timezone suffix. Convert project-local selections to UTC before calling. Applies to every exported time series.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$
Example:

"2026-05-20T00:00:00"

toDate
string
required

Exclusive range end in UTC, formatted as YYYY-MM-DDTHH:MM:SS without a timezone suffix. Must be after fromDate; the maximum range depends on the interval.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$
Example:

"2026-06-20T00:00:00"

interval
string
required

Aggregation interval, applies to every exported time series. One of: hourly, daily, monthly.

Example:

"daily"

format
string
required

File format, applies to every exported time series. One of: csv, parquet.

Example:

"csv"

timeSeries
object[]
required

Time series to export, one file each. Names must be unique within the request.

Required array length: 1 - 20 elements

Response

Newline-delimited JSON progress stream; the final line carries the export descriptor.

One line of the export progress stream.

type
enum<string>
required
Available options:
started,
progress,
completed,
failed
exportID
string
required
series
string

Time series name the progress event refers to

sliceFrom
string

Start of the time slice just written (progress)

sliceTo
string

Exclusive end of the time slice just written (progress)

rows
integer<int64>

Rows written for this series so far (progress)

bytes
integer<int64>

Bytes written for this series so far (progress)

export
object