# Retrieve Global Settings

Retrieve global network configurations.

Endpoint: GET /network/{network_id}/sounding/settings
Security: ApiKey

## Path parameters:

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

## Response 200 fields (application/json):

  - `zone_priority_list` (array)
    Locations the device selection algorithm will prioritize.
    Example: ["Kitchen"]

  - `motion_events_enabled` (integer)
    Enable motion events. On detected motion, the network emits a .
    Enum: 0, 1

  - `device_events` (integer)
    Enable Device Connection Events. 

 Requires global  to equal  and individual devices'  to equal . When the connection state of device changes, an event is emitted. Possible events are: ,  and
    Enum: 0, 1

  - `motion_history_enabled` (number)
    Enable historical motion data from the network. The data can be queried through the Motion History APIs.
    Enum: 0, 1

  - `mesh_auto_disable` (integer)
    Disable motion detection on all current and added mesh nodes.
    Enum: 0, 1

  - `mesh_sounding_disabled` (array)
    Mesh nodes that are disabled for motion detection. To alter this array, set  on the clients API or enable
    Example: []

  - `motion_events_armed` (integer)
    Enable storage of motion events. Requires  to be enabled. The stored events can be queried through the Events APIs.
    Enum: 0, 1

  - `motion_paused` (integer)
    Pauses all motion detection. While paused, the network can't receive setting changes.
    Enum: 0, 1

  - `leafblower_cutoff` (number)
    Advanced - Minimum score for device selection algorithm.
 -1.1 ignores the device's quality, and always uses them for motion detection. This feature should be used in conjunction with the  features.

  - `link_limit` (number)
    Maximum number of motion-detecting devices per access point or mesh node

  - `pet_mode` (integer)
    When enabled, pet motion is less likely to generate a . Is expected to be used when global sensitivity is set to high (1.0).  While it is possible to bypass this configuration, alterations to individual client devices or to other global values may yield reduced event performance.

-  - Disable Pet-mode

-  - Enable Pet-mode
    Enum: 0, 1

  - `cooldown` (integer)
    Represents the duration of inactivity following a , that the network keeps monitoring for motion. Once inactivity is observed, the network emits a  and concludes the event window.
    Example: 120

  - `sensitivity` (number)
    Global motion detection sensitivity (1.0 - high, 2.0 - medium, 3.0 - low, 7.0 - very-low)
    Example: 1

  - `sounding_mode` (string)
    This parameter controls the default device selection policy for the network, the two policy modes are allow and deny.

Allow mode: devices will be selected as best determined by the device selection algorithm. Devices can be blocked from selection by setting txenble=0 for that leaf(s).

Deny mode: devices that are not explicitly listed via a whitelist will be disallowed from sounding.

 Note switching this mode will clear any existing device device availability settings and all devices will revert to available for  mode or unavailable for  mode.
    Enum: "allow", "deny"

## Response 404 fields (application/json):

  - `error` (string)
    network not found
    Example: "something went wrong"