# Events, History, and Visualizations

## Tag Motion Detected Event

 - [POST /event_tag](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/post_event_tag.md)

## Motion History Densities

 - [GET /motion_history_densities](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_motion_history_densities.md): Returns historical motion densities for a given period of time. Densities are percentages representing how many samples within a bucket-size had motion values greater than zero.

For example, if the bucket size was 60 seconds, and 11 of the 12 possible 5s buckets had motion then a value of 91.6 would be returned.

It should be noted that data is stored in two resolutions:

1s intervals for the last 24 hours.
5s intervals for the last week.
Which means that densities computed on data within the last 24 hours may be retrieved with this request at sub 5s bucket sizes.

This request may return data at a coarser resolution than the requested bucket size, if data at that resolution is not available.

Timestamp ranges are limited by Halo Home to only include times over which the network was last claimed.

## Last Motion Detected Timestamp

 - [GET /network_statuses](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_network_statuses.md)

## Motion Detected Detail View

 - [GET /location_histograms](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_location_histograms.md)

## Network Topology

 - [GET /topologies](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_topologies.md): Provides the topology of the network.

## Hourly Motion Histograms

 - [GET /motion_history_intensities](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_motion_history_intensities.md): Returns historical motion intensities for a given period of time. Intensities are actual motion values stored at two different resolutions (bucket sizes):

 - 1s intervals for the last 24 hours.
 - 5s intervals for the last week.
This request may return data at a coarser resolution than the requested bucket size, if data at that resolution is not available.

Timestamp ranges are limited by Halo Home to only include times over which the network was last claimed.

## Live Motion Websocket

 - [GET /motions](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_motions.md): Open a Websocket connection streaming live motion data.

## Network Event History

 - [GET /events](https://docs.cognitivesystems.com/assets/specs/api/app_cloud/events-history-and-visualizations/get_events.md)