# [BETA] Device Motion Location History

History of device motion density over a requested time window. Provides the  and / or  fields when they are set. Indicates whether the device is a  or . The results always include the mac address of the device.

Endpoint: GET /network/{network_id}/location/history
Security: ApiKey

## Path parameters:

  - `network_id` (integer, required)
    Motion Network ID

## Query parameters:

  - `from` (integer)
    UTC unix timestamp to search motion from. Defaults to 1 hour ago from a provided 'to'.

  - `to` (integer)
    UTC unix timestamp to query motion until. Defaults to now.

  - `bucket` (integer)
    Bucket size. Recommended use is 60.

## Response 200 fields (application/json):

  - `locations` (array)

  - `locations.mac` (string,null)
    Assigned friendly name of device if provided. May be the device id in the case of the sounding device being a mesh node.

  - `locations.friendly_name` (string,null)
    Assigned friendly name of device if provided

  - `locations.type` (string,null)
    One of "LEAF", "MESH_NODE" or "MESH_ROOT"

  - `locations.location` (string)
    Location name that the device was assigned. Where location is not assigned, or in the case of an extender, this may be the mac address of the device, or the identifier of a node in a mesh network.

  - `locations.data` (array)
    Array of data points of location history for requested time window, with each item in the array as a data point: .