The following endpoints refer to querying time-series data from Variables
Variables Array
Both Get Data Series and Get Data Statistics accept a variables key in the request body. It is an array of objects, each identifying a Variable to query.
Variables can be referenced by their ID or by label using the ~ prefix (e.g., ~temperature). Label-based resolution is case-insensitive.
When referencing a variable by ~label, either device or deviceGroup must be provided to uniquely resolve it.
| Field | Type | Required? | Description |
|---|---|---|---|
| variable | String | Yes | Variable ID or ~label (e.g., ~temperature) |
| device | String | No | Device ID or ~label. Required when variable is specified by ~label |
| deviceGroup | String | No | Device Group ID or ~label. Alternative to device when resolving variables by label |