Retrieve time series data

GET {{baseUrl}}/timeseries/:entityId/:propertySetName?from=<dateTime>&to=<dateTime>&limit=2000&select=<string>&sort=asc&latestValue=false

Retrieve time series data for one combination of an asset (entity) and an(a) aspect (property set). The maximum number of time series data items returned per request is defined by parameter limit. In case more time series data items are present in the requested time range, only a subset of data items will be returned and a header link is added to the response. The header value contains the request URL to fetch the next set of time series data items, by increasing the from parameter accordingly. Returns the latest available timestamp record if no range is provided. Note:

If no range is provided, Based on Customer data ingestion timestamp record, it may not contain all variables of aspect. For example, an Aspect has 5 variables; but latest timeseries record has only 3 variables with values. Only latest timeseries record will be returned in response with values of 3 variables only. It will not fetch latest value of all 5 variables of aspect.

Request Params

KeyDatatypeRequiredDescription
fromstringBeginning of the time range to be retrieved (exclusive).
tostringEnd of the time range to be retrieved (inclusive).
limitnumberMaximum number of time series data items to be retrieved.
selectstringComma-separated list of properties to be returned. By default all properties of an(a) aspect (property set) are considered.
sortstringDefine sorting order of returned data. Sorting can be chronologically ascending (<i>asc</i>) or descending (<i>desc</i>).
latestValuebooleanIf true, only the latest value of each property is returned. Latest values must be at least 5 Minutes old and at maximum 90 days old, in order to be considered. The returned values might be co-located or spread over multiple timestamps. Each property appears at max once in the response. The select parameter can be used to limit the properties to be considered. Parameters from, to, and limit must not be used in conjunction with latest. The response only includes latest value with good and uncertain quality codes

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

[{&quot;_time&quot;:&quot;\u003cdateTime\u003e&quot;},{&quot;_time&quot;:&quot;\u003cdateTime\u003e&quot;}]