# Detailed live motion

Opens connection to stream live motion data from the network. The websocket will stream motion data updates live from the network until closed.

Endpoint: GET /network/{network_id}/motion/live
Security: ApiKey

## Path parameters:

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

## Response 200 fields (application/json):

  - `count` (number)
    Number of samples (number of strides in the  inner data dimension) - always 1

  - `loc` (array)
    The first entry is a string representing the MAC addresses near which motion has been localized.  If present, the second entry is p_confidence a float representing how sure the algorithm is of its decision.

  - `loc_name` (string)
    User indicated location of the device being localized to in loc field (if provided, empty string otherwise)

  - `loc_conf` (array)
    The location confidence information as an array of number (float) for the corresponding loc output index. Available as debug output values when Guardian Config -> live_motion -> loc_conf_enable = 1. Supported as of GuardianCore = 0.7.2

  - `links` (array)
    Array of link IDs (outer data dimension). Format is dst_mac-src_mac

  - `interval` (number)
    Milliseconds/sample (stride time of inner data dimension) - always 500ms

  - `ts` (number)
    Timestamp of the first sample in the stream (start time of inner data dimension)

  - `last_motion` (number)
    UTC timestamp

  - `data` (object)
    Data fields as 2D arrays

  - `data.mkai` (array)
    Average Motion Intensity - Links Dimension

  - `data.throughput` (array)
    Normalized throughput for this sample - Links Dimension

  - `data.mconf` (array)
    Motion level confidence threshold - Links Dimension

  - `data.msad` (array)
    Un-gated average SAD - Links Dimension

  - `data.lraw` (array)
    Unadjusted motion intensity - Links Dimension

  - `data.o.rst` (array)
    (debug-only) motion detection internal reset flag indicator - Links Dimension

  - `data.o.bw` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.snr` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.nse` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.pwr` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.dnse` (array)
    (debug-only) motion detection internal rejection reason

  - `data.o.dsnr` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.dsne` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.o.dpwr` (array)
    (debug-only) motion detection internal rejection reason - Links Dimension

  - `data.snr` (array)
    (debug-only) motion snr value - Links Dimension

  - `data.jconf` (array)
    (debug-only) Secondary gate internal motion threshold - Links Dimension

  - `data.jraw` (array)
    (debug-only) Secondary ungated internal motion value - Links Dimension

  - `data.jtype` (array)
    (debug-only) Secondary internal motion type - Links Dimension

  - `data.zzscore` (array)
    (debug-only) Metric indicator for csi stability, available in newer omot 4x

  - `data.mdbg` (array)
    (debug-only) Array of numbers of motion debug values