# Time Series

The Time Series endpoints are used for sending or receiving telemetry data. Once a `Capability` twin has been created that represents the time series, the telemetry associated with that twin can be created using either the twin's dtId (aka twinId) or externalId, a timestamp, and a value. Data is transmitted as an array so time series data can be batched and sent within a single request.
Similarly, time series can be retreived for one or more `Capability` twins at a time using the twinId(s).

## Insert time series values

 - [POST /time-series](https://developers.willowinc.com/openapi/willow-api/time-series/posttelemetry.md)

## Retrieve a time series

 - [GET /time-series/{twinId}](https://developers.willowinc.com/openapi/willow-api/time-series/gettimeseriesbyid.md)

## Retrieve the latest value

 - [GET /time-series/{twinId}/latest](https://developers.willowinc.com/openapi/willow-api/time-series/gettimeseriesbyidlatest.md)

## Retrieve multiple time series

 - [POST /time-series/ids](https://developers.willowinc.com/openapi/willow-api/time-series/gettimeseriesids.md)

## Retrieve multiple latest values

 - [POST /time-series/ids/latest](https://developers.willowinc.com/openapi/willow-api/time-series/gettimeseriesidslatest.md)