> ## Documentation Index
> Fetch the complete documentation index at: https://docs-old.tilebox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Timeseries

> Timeseries datasets associate each data point with a specific timestamp, making them well suited for organizing and querying time-ordered observations.

Each timeseries dataset comes with a set of required and auto-generated fields for each data point.

## Required fields

While the specific data fields between different time series datasets can vary, there are common fields that all time series datasets share.

**time** `Timestamp`

The timestamp associated with each data point. Timestamps are always in UTC.

> [!TIP]
>
> For indexing and querying, Tilebox truncates timestamps to millisecond precision. But Timeseries datasets may contain arbitrary custom `Timestamp` fields that store timestamps up to a nanosecond precision.

## Auto-generated fields

**id** `UUID`

A [universally unique identifier (UUID)](https://en.wikipedia.org/wiki/Universally_unique_identifier) that uniquely identifies each data point. IDs are generated so that sorting them lexicographically also sorts them by time.

> [!TIP]
>
> IDs generated by Tilebox are deterministic, meaning that ingesting the exact same data values into the same collection will always result in the same ID.

**ingestion\_time** `Timestamp`

The time the data point was ingested into the Tilebox API.

## Creating a timeseries dataset

To create a timeseries dataset, use the [Tilebox Console](https://docs-old.tilebox.com/console.md) and select `Timeseries Dataset` as the dataset type. The required and auto-generated fields
already outlined will be automatically added to the dataset schema.

## Time-based queries

Timeseries datasets support time-based queries. To query a specific time interval, specify a time range when [querying data](https://docs-old.tilebox.com/datasets/query/filter-by-time.md) from a dataset or a collection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.