> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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.

<ParamField path="time" type="Timestamp">
  The timestamp associated with each data point. Timestamps are always in UTC.
</ParamField>

<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.
</Tip>

## Auto-generated fields

<ParamField path="id" type="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.
</ParamField>

<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.
</Tip>

<ParamField path="ingestion_time" type="Timestamp">
  The time the data point was ingested into the Tilebox API.
</ParamField>

## Creating a timeseries dataset

To create a timeseries dataset, use the [Tilebox Console](/console) 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](/datasets/query/filter-by-time) from a dataset or a collection.