# Motion event pairs

Fetch motion event pairs, which will be a pair of MotionDetectedEvent and MotionStoppedEvent events.

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

## Path parameters:

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

## Query parameters:

  - `from` (integer)
    UTC timestamp

  - `to` (integer)
    UTC timestamp.

  - `last` (integer)
    n events to pair from. Defaults to 50.

## Response 200 fields (application/json):

  - `pairs` (array)
    Array of MotionDetectedEvent & MotionStoppedEvent pairs.
    Example: [{"_id":"64adc55a8d4288001b9c8e34.64adc5508d4288001b9c8e31","event":"MotionEventPair","ts":1699112349,"guardian_id":"5dc5cfe59b12797e2e3e362f","link_id":"4C72900A6B.30894ab76326","intensity_window":[0.3,0.56,0.43,0.27,0.13,0,0.04],"loc_name":"","link_dst_name":"4C72900A6B","link_src_name":"30894ab76326","evt_detected_ts":1689109839,"evt_stopped_ts":1689109850,"debug":{"linkSens":{},"msad":[187.22],"links":["4C72900A6B.30894ab76326"],"mconf":[80],"sens":1},"network_id":156,"tag":"          "}]

  - `pairs._id` (string)
    Dot seperated id's of paired events.
    Example: "64adc55a8d4288001b9c8e34.64adc5508d4288001b9c8e31"

  - `pairs.event` (string)
    Example: "MotionEventPair"

  - `pairs.ts` (integer)
    UTC timestamp of MotionEventPair generation.
    Example: 1699112349

  - `pairs.guardian_id` (string)
    Unique network identifier.
    Example: "5dc5cfe59b12797e2e3e362f"

  - `pairs.link_id` (string)
    Identifiers for link causing MotionDetectedEvent.
    Example: "4C72900A6B.30894ab76326"

  - `pairs.intensity_window` (array)
    Example: [0.3,0.56,0.43,0.27,0.13,0,0.04]

  - `pairs.loc_name` (string)
    Location string

  - `pairs.link_dst_name` (string)
    Link Node identifier.
    Example: "4C72900A6B"

  - `pairs.link_src_name` (string)
    Link Lead identifier.
    Example: "30894ab76326"

  - `pairs.evt_detected_ts` (integer)
    UTC timestamp of MotionDetectedEvent.
    Example: 1689109839

  - `pairs.evt_stopped_ts` (integer)
    UTC timestamp of MotionStoppedEvent.
    Example: 1689109850

  - `pairs.debug` (object)
    Motion detection parameters from event generator. Used for debug and sensitivity calibration purposes. Present in MotionStoppedEvent on newer firmware.
    Example: {"linkSens":{},"msad":[187.22],"links":["4C72900A6B.30894ab76326"],"mconf":[80],"sens":1}

  - `pairs.debug.linkSens` (object)
    Object containing per-link sensitivity values.
    Example: {}

  - `pairs.debug.msad` (array)
    Array of msad values corresponding to the peak observed from each link.
    Example: [187.22]

  - `pairs.debug.links` (array)
    Array of links involved in MotionDetectedEvent trigger.
    Example: ["4C72900A6B.30894ab76326"]

  - `pairs.debug.mconf` (array)
    Array of mconf values causing event to trigger.
    Example: [80]

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

  - `pairs.network_id` (integer)
    Unique numerical network identifier.
    Example: 156

  - `pairs.tag` (string)
    User set event tag.
    Example: "          "

  - `status` (number)
    Integer showing success code of pairing.  means complete failure,  means success,  means partial success.

  - `failures` (array)
    Array of pairing failures.
    Example: [{"_id":"64de6bbde5b9e4001b6aafba","event":"MotionDetectedEvent","ts":1692298172.06,"failed_reason":"\"mconf\" must contain at least 1 items"}]

  - `failures._id` (string)
    Event ID.
    Example: "64de6bbde5b9e4001b6aafba"

  - `failures.event` (string)
    Event name.
    Example: "MotionDetectedEvent"

  - `failures.ts` (number)
    Timestamp of the event.
    Example: 1692298172.06

  - `failures.failed_reason` (string)
    Reason for pairing failure. NOTE: failures are often caused by old firmware.
    Example: "\"mconf\" must contain at least 1 items"