# Network event history

Retrieve a list of events.

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

## Path parameters:

  - `network_id` (integer, required)
    Motion Network ID (returned as 'id' by Find API calls)

## Query parameters:

  - `from` (integer)
    To go FORWARD in time, provide the UTC timestamp of the newest report client has received.

  - `to` (integer)
    To go BACK in time, provide the UTC timestamp of the oldest report client has received.

  - `filter` (string)
    Only return a particular category of event: Link, Network, Motion

  - `last` (integer)
    Maximum number of events to return, default is 10

  - `sort` (boolean)
    When true the returned events will be post-sorted by timestamp (in case it's possible they were written out of order)

  - `event_types` (string)
    Specifies the event parameter used to filter the query results

## Response 200 fields (application/json):

  - `_id` (string)
    Event uuid (for tagging)

  - `category` (string, required)
    Event category (for filtering)
    Enum: "Link", "Network", "Motion", "System"

  - `loc` (array)
    Event location

  - `detail` (object)
    Event detail k/v pairs

  - `link_dst_name` (string)
    Link destination friendly name

  - `network_id` (integer, required)
    Guardian network_id

  - `ts` (number, required)
    UTC timestamp

  - `evt_detected_ts` (number)
    Present in MotionStoppedEvent. References the UTC timestamp of preceding MotionDetectedEvent.

  - `intensity_window` (array)
    Array of float, of length guardian_config.motion_events.density_window -1  (Nominally len 7). Corresponds to the motion intensity values in the integration buffer at the time of the DetectedEvent.

  - `link_id` (string)
    DST_MAC-SRC_MAC using 3 lsbs of each address and without the colons. Ex: 001122-001133

  - `loc_name` (string)
    First location friendly name

  - `tag` (string)
    Event tag.  Note that this field is always space-padded to 10 characters.

  - `link_src_name` (string)
    Link source friendly name

  - `guardian_id` (string, required)
    Guardian deviceId

  - `node_id` (integer)
    Database id of this node that generate the event

  - `deviceId` (string)
    Device identification, such as mac address

  - `node_name` (string)
    Alternative device identification, that can be used by vendor from deviceId

  - `debug` (object)
    Motion detection parameters from event generator. Used for debug and sensitivity calibration purposes. Present in MotionStoppedEvent on newer firmware.

  - `debug.linkSens` (object)
    Object containing per-link sensitivity values.

  - `debug.msad` (array)
    Array of msad values corresponding to the peak observed from each link.

  - `debug.links` (array)
    Array of links involved in MotionDetectedEvent trigger.

  - `debug.mconf` (array)
    Array of mconf values causing event to trigger.

  - `debug.sens` (number)
    Sensitivity value of the network observed at MotionStoppedEvent

  - `armed` (integer)
    Feedback of armed from GuardianConfig.motion_events

If 0, this event will not be stored in history or pushed to the user.

  - `event` (string, required)
    Event identifier
    Enum: "MotionDetectedEvent", "MotionStoppedEvent", "LinkConnectedEvent", "LinkDisconnectedEvent", "LinkLowThroughputEvent", "LinkCreatedEvent", "MemberArrivedEvent", "MemberLeftEvent", "MemberJoinedEvent", "MemberRemovedEvent", "UserClaimedNetworkEvent", "SceneChangedToAwayEvent", "SceneChangedToHomeEvent", "SceneChangedToExcessiveMotionEvent", "SceneChangedToGuardianEvent", "NetworkDestroyedEvent", "NetworkCreatedEvent", "NetworkResetEvent", "NetworkRadarConnectedEvent", "NetworkRadarDisconnectedEvent", "NetworkMotionConfigChangedEvent", "NetworkSceneConfigChangedEvent", "NetworkChangedEvent", "SystemConnectedEvent", "SystemDisconnectedEvent", "DeviceConnectedEvent", "DeviceDisconnectedEvent", "DeviceTimedOutEvent", "CustomAlertEvent", "VaultFlushRequest", "VaultFlushResponse"

  - `_consumer` (string)
    The consumer for Custom Alerts.

  - `data` (object)
    Data from Custom Alerts.

  - `data.title` (string)
    Title

  - `data.uuid` (string)
    UUID id

  - `data.id` (integer)
    User id

  - `data.first_name` (string)
    F Name

  - `data.last_name` (string)
    L Name

  - `data.sub` (string)
    Unique identifier from Cognito SSO provider.

  - `data.user` (object)
    User data