====GETHISTORY====

===Parameters===

^Order^Name^Type^Desc^
|1|points|[[point list|point list]]|A list of points to get history for|
|2|options|[[map|map]]|A list containing query options|

===Returns===

Places a [[point list|list of points]] onto the stack with history for each of the points.

===Description===

Gets history information for every point in the point list.

The map can (optionally) contain any of the following...

^Key^Default^Meaning^
|type|interp|The type of request - values include **interp** (interpolated), **continue** (interpolated data without preceeding values) and **raw** (raw data).|
|start|now - 1 days|The start time for the query, in UTC YYYY-MM-DD hh:mm:ss format|
|end|now|The end time for the query, in UTC YYYY-MM-DD hh:mm:ss format|
|grain|-100|The number of seconds between samples (positive), or the number of samples in the returned data (ifnegative)|
|tz|UTC|Name of the time-zone that the requested range and returned values are in. May be //local// to use the configured time-zone of the ARDI site.|

===Example===

**A('TE101') P('Temperature') POINTS { "start": "2020-01-01 00:00:00", "end": "2020-01-02 00:00:00" } GETHISTORY**

This function will return a point for Temperature on asset TE101, if such a point exists.

===See Also===

[[fLAG]] \\