# Retrieve Client Configuration

Retrieve sounding clients and configurations.

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

## Path parameters:

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

## Response 200 fields (application/json):

  - `devices` (array)

  - `devices.device_id` (string)
    When  is true, this is the serial number of the AP.   When  is true, this is the serialNumber of the extender device (or Masked-Mac if unavailable). 

 Nodes & Extenders only

  - `devices.device_info` (object)
    Device info record

  - `devices.device_info.device_type` (string)
    Human-readable identification string for this device

  - `devices.device_info.hostname` (string)
    Device hostname (if available)

  - `devices.device_info.mac` (string)
    Device MAC address

  - `devices.device_info.os` (string)
    Operating System

  - `devices.device_info.name` (string)
    Device name

  - `devices.device_info.category` (string)
    Device category

  - `devices.device_info.brand` (string)
    Brand name

  - `devices.device_info.model` (string)
    Model name

  - `devices.device_info.modelNumber` (string)
    Model number

  - `devices.device_info.ts` (number)
    Timestamp of last identification

  - `devices.friendly_name` (string)
    Human readable name assigned to the leaf of Node.

  - `devices.id` (integer)
    If is_node is true, this value will be >0 and is the node_id of the AP.

 Nodes only

  - `devices.is_extender` (boolean)
    When  is true, indicates if this device is an extender (not full node).

  - `devices.is_node` (boolean)
    Indicates if the device is a mesh participant (true) or a client device (false).

  - `devices.is_online` (boolean)
    true if the device is currently online

  - `devices.omot_version` (string,null)
    Algorithm version

  - `devices.is_root` (boolean)
    When  is true, indicates if this device is the root master.

 Nodes only

  - `devices.location` (string)
    Device location name.

  - `devices.sensitivity` (number)
    Current sensitivity of the device.

  - `devices.sensitivity_mode` (string)
    indicates whether the device is using the global sensitivity setting or is being overridden at the device level.
    Enum: "override", "global"

  - `devices.sounding_mode` (string)
    Indicates if this device can be used for sounding.

 Leafs & Extenders only
    Enum: "allow", "deny"

  - `devices.sounding_mesh` (string)
    Indicates if this device can be used for mesh link sounding.

If set to deny the Node in question will refuse mesh sounding connections

 Nodes only
    Enum: "allow", "deny"

  - `devices.mac` (string)
    This is the MAC address of the client device.

 Leafs & Extenders only

  - `devices.sounding_status` (boolean)
    Indicates if the device is currently actively sounding.

  - `devices.sounding_status_reason` (string)
    The reason code related to the selection choice determined by leafblower
    Enum: "N/A", "NO_DATA", "NOT_SOUNDED", "PASS", "NOT_PRESENT", "SLEEPING", "NOISY", "BROKEN"

  - `devices.sounding_status_score` (number)
    The last score that leafblower assigned to this device.

  - `devices.sounding_warmup` (boolean,null)
    Leafblower is currently determining the quality of the sounding state of the device.

Please note that the sounding_score is not considered stable until this is false.

  - `devices.links` (array)
    Low-level information on active sounding links

  - `devices.links.src_id` (integer)
    id of the node sounding this client

  - `devices.links.rssi` (string)
    Received Signal Strength on this link (dBm) from ifconfig

  - `devices.links.if_ch` (integer,null)
    WiFi Interface channel

  - `devices.sounding_history` (object,null)
    Object containing per-link historical sounding state

  - `devices.sounding_history.0` (integer)
    NOT_SOUNDED

  - `devices.sounding_history.1` (integer)
    PASS

  - `devices.sounding_history.2` (integer)
    NOT_PRESENT

  - `devices.sounding_history.3` (integer)
    SLEEPING

  - `devices.sounding_history.4` (integer)
    NOISY

  - `devices.sounding_history.5` (integer)
    BROKEN

  - `devices.sounding_history.-1` (integer)
    NO DATA

## Response 404 fields (application/json):

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