# Find by Meta field : You will have to urlencode the query string here, use the library provided by your runtime. Example queries where 'val' is a partial string match (use % as wildcard char): (this will match the guardian_env key of the network meta blob) (this will match the systemName key of the dwm object in the network meta blob) Example query checking for existence of a field (omit val to directly execute): Endpoint: GET /network/find/meta/{query} Security: ApiKey ## Path parameters: - `query` (string, required) Guardian device ID ## Query parameters: - `val` (string) Value to search for - `array` (boolean) The default behavior is to return an array when there are multiple results and a single object in the case of a single result. When this parameter is true the response will always be an array. - `expandNodes` (boolean) If true, will also return an array of all nodes belonging to this network under the 'nodes' key. ## Response 200 fields (application/json): - `last_guardian_status` (object,null) Status report emitted by the network on a regular interval. Contains information on the network's topology, health and motion detection metrics. - `last_guardian_status.leafblower` (object) Leafblower Link Stats object, key is mac address - `last_guardian_status.network_id` (integer) Network numeric ID - `last_guardian_status.shard_id` (string) Network shard - `last_guardian_status.radars` (object) map of radar id to radar status reports - `last_guardian_status.ts` (number, required) UTC timestamp - `last_guardian_status.last_motion` (number,null) UTC timestamp of last motion refresh time - `last_guardian_status.motion_tripped` (integer) Motion detector current state (1 - tripped, 0 - no motion) - `last_guardian_status.startup` (boolean) Is this the first report after startup - `last_guardian_status.version` (object) Component version inside Guardian - `last_guardian_status.health` (object) network and radar health - `last_guardian_status.health.nodes` (object) Health score at node level - `last_guardian_status.health.network` (number) Health score at network level - `last_guardian_status.capabilities` (array) (alpha) list of device capabilities to unlock specify cloud options - `last_guardian_status.coverage` (object) Leafblower room coverage per node, key is node id, value is coverage array - `last_guardian_status.guardian_id` (string) Network guardian_id - `last_guardian_status.dhcp` (object) map of dhcp mac address and dhcp stats object - fused across all AP - `last_guardian_status.motion_enabled` (integer) Motion event generation state (1 - on, 0 - off) - `last_guardian_status.armed` (integer) Motion armed state (1 - on, 0 - off) - `last_guardian_status.paused` (boolean) When enabled, the system is in sounding paused mode, and no motion detection will be happening. The motion stack is in dormant mode until the sounding more is no longer paused. - `radar_config` (object) Configuration that's shared by all Nodes in this Motion Network. - `radar_config.dynamic_sensitivity` (string) Dynamic sensitivity enable (for development only) - `radar_config.bridge` (object) - `radar_config.bridge.statusInterval` (integer) Period (in seconds) of status report generation - `radar_config.bridge.zmqPort` (integer) Userspace ZMQ server port - `radar_config.bridge.loglevel` (string) syslog output verbosity level Enum: "debug", "info", "error" - `radar_config.bridge.zmqHost` (string) Userspace ZMQ server hostname - `radar_config.bridge.linkExpiry` (integer) After how many seconds of inactivity is the CFR state for that link de-allocated. - `radar_config.bridge.debug` (integer) When set to 1 application will output additional debug fields in the motion-mesh reports. - `radar_config.bridge.debug_status` (integer) When set to 1 application will output additional debug fields in radar status reports. - `radar_config.bridge.vault` (integer) When set to 1 application will output motion-raw radio debug reports. - `radar_config.motion80211` (object) - `radar_config.motion80211.txEnable` (object) Key is leaf MAC, value is one of: "" - automatic (default) "1" - force sounding "0" - disable sounding - `radar_config.motion80211.linkSens` (object) Key is a link ID, value is sensitivity delta for this link. Default is . - `radar_config.motion80211.hyperSensOverride` (array) A list of device IDs for which hyper_sensitive omot mode is enabled regardless of platform - `radar_config.motion80211.noise_ctrl` (integer) Noise adaptation mode (0-2). 0- normal threshold, 1- less sensitive threshold, 2- no threshold applied (unsupported demo mode) - `radar_config.motion80211.cfrMode` (string) Motion detection algorithm switch (legacy), no other value is supported - `radar_config.motion80211.period` (integer) Nominal Beacon/Solicitation Period (ms) - `radar_config.motion80211.meshAutoDisable` (integer) Mesh sounding auto disable at registration time - `radar_config.motion80211.meshSoundingDisabled` (array) A list of device IDs for which mesh sounding is disabled - `radar_config.motion80211.sens` (number) Motion Detection Sensitivity (1.0 - high, 2.0 - medium, 3.0 - low, generally bigger => less motion) - `radar_config.motion80211.forceTxEnable` (integer) If set to 1 will disable leafblower controller and sound all available leaf links at all times. - `radar_config.motion80211.pingerEnable` (object) Key is leaf MAC, value is one of: "" - automatic (default) "1" - force ping "0" - disable pinging - `radar_config.motion80211.ping_rate` (integer) The rate in milliseconds for ping period for all macs - `radar_config.motion80211.optmode` (object) Key is leaf MAC, value is integer, allows for custom mode of motion algorithm, default is empty string. Supported after motion algo 4.3.1 - `radar_config.motion80211.mpdf_threshold` (object) Key is leaf MAC, value is number float threshold, default is empty string. Supported after motion algo 4.3.1 - `radar_config.motion80211.dmEnable` (number) - `guardian_config` (object) Configuration for gateway or mesh root. - `guardian_config.history_motion` (object) - `guardian_config.history_motion.count` (integer) Number of values per report - `guardian_config.history_motion.enable` (integer) - `guardian_config.history_motion.interval` (integer) Sample period (milliseconds) per value - `guardian_config.history_motion.flush_interval` (integer) Specifies the number of 500ms ticks to wait after a , before sending an early message. - `guardian_config.device_events` (object) - `guardian_config.device_events.enable` (integer) Cloud only. Specifies if Device Events feature is enabled. - `guardian_config.live_motion` (object) - `guardian_config.live_motion.enable` (integer) Live motion (#model:PMznYr2J4pFFyKg4h) enable - `guardian_config.live_motion.force_enable` (integer) Live motion enable override - `guardian_config.live_motion.interval` (integer) Live motion sample period - `guardian_config.live_motion.loc_conf_enable` (integer) This toggles the location confidence value by setting loc_conf_enable=1. This data will appear in the motion matrix if the firmware supports it. - `guardian_config.link_events` (object) - `guardian_config.link_events.enable` (integer) When set to 1, enables the Link event generator - `guardian_config.link_events.throughput_threshold` (number) The minimum throughput required to NOT issue a LinkLowThroughputEvent - `guardian_config.link_events.idle_link_timeout` (integer) How long (sec) must a link have zero throughput before a LinkIdleEvent is issued - `guardian_config.link_events.throughput_cooldown` (integer) The minimum interval (sec) between two LinkLowThroughputEvents - `guardian_config.link_events.noise_duration` (integer) How long (sec) the noise level must exceed noise_threshold to issue a LinkHighNoiseEvent - `guardian_config.link_events.noise_cooldown` (integer) The minimum interval (sec) between two LinkHighNoiseEvents - `guardian_config.link_events.noise_threshold` (integer) The noise level required to issue a LinkHighNoiseEvent - `guardian_config.link_events.throughput_duration` (integer) How long (sec) must the throughput be under throughput_threshold to issue a LinkLowThroughputEvent - `guardian_config.leafblower` (object) - `guardian_config.leafblower.cutoff` (number) Minimum score for leafblower to sound a client device - `guardian_config.leafblower.blower_size` (integer) Maximum number of entries in the system leafblower table - `guardian_config.leafblower.log_debug` (integer) Sets the debug logging inside leafblower - `guardian_config.leafblower.link_expiry` (integer) Reset link history after this many inactive cycles (default is 1 week) - `guardian_config.leafblower.sneaky_cutoff` (number) Minimum score for leafblower to sneaky sound device (alpha) - `guardian_config.leafblower.sneaky_link_limit` (integer) Number of maximum devices to be sneaky sounded (alpha) - `guardian_config.leafblower.whitelist` (object) Key is MAC, value 0 is same as absent all other values mean enabled. - `guardian_config.leafblower.link_limit` (integer) Target number of leaf sounding links per AP - `guardian_config.leafblower.whitelist_enable` (integer) When enabled, only leaf MACs in whitelist will be sounded. - `guardian_config.leafblower.cycle_count` (integer) Evaluation cycle time (in radar status rate) - `guardian_config.leafblower.cycle_time` (integer) Deprecated, do not use. - `guardian_config.debug` (object) - `guardian_config.debug.status` (integer) Force status fusion every 1min (disables heartbeats) when 1 - `guardian_config.debug.leafblower` (integer) Send additional leafblower debug reports when 1 - `guardian_config.debug.gateway` (integer) Enable debug gateway mode (forward all reports from nodes to cloud) - `guardian_config.debug.zilker` (integer) Enable Zilker testing mode. - `guardian_config.user_priority` (array) The list of user priority rooms in order from highest to lowest - `guardian_config.motion_events` (object) - `guardian_config.motion_events.enable` (integer) Enable motion event generation. - `guardian_config.motion_events.threshold` (number) This value is subtracted from all per-link motion - `guardian_config.motion_events.pet_mode` (integer) Controls the guardian pet mode settings, indicates the size in pounds for largest pet in the house. Overrides density_thres and min_duration locally - `guardian_config.motion_events.cooldown` (integer) Minimum period between successive MotionDetectedEvent (sec) - `guardian_config.motion_events.excessive_mins` (integer) If not 0, a MotionExcessiveEvent will be fired when excessive_mins minutes of motion are detected over an excessive_mins/excessive_density minute window. - `guardian_config.motion_events.excessive_density` (number) Normalized motion density that's considered excessive - `guardian_config.motion_events.armed` (integer) Controls reporting of motion events to user and storing them to history - `guardian_config.motion_events.override` (object) Advanced controls for QA/R&D only - `guardian_config.motion_events.override.min_duration` (number) How long the intensity or desnity level must exceed thresholds to issue a MotionDetectedEvent (sec) - `guardian_config.motion_events.override.density_window` (integer) Number of 500ms samples to integrate density across - `guardian_config.motion_events.override.density_thres` (number) The minimum motion density (sum of intensity in a 5s? window) to consider sending a MotionDetectedEvent - `guardian_config.motion_events.override.intensity_thres` (number) The motion intensity level required to consider sending a MotionDetectedEvent - `created_at` (number, required) UTC second timestamp of network creation. - `updated_at` (number, required) UTC second timestamp of last configuration update. - `guardian_id` (string, required) Unique network identifier. Populated by on network creation. - `last_heard` (number) UTC timestamp of last message. - `meta` (object) Network metadata storage. - `meta.dwm` (object) value mapping used for fleet's organization - `meta.dwm.groupId` (any) (internal) group ID numbering for the network - `meta.dwm.systemName` (string) (internal) system friendly used for labelling and organization - `meta.dwm.systemType` (string) (internal) system type used for labelling and organization - `meta.dwm.systemOwner` (string) (internal) system owner used for labelling and organization - `meta.dwm.configurationType` (string) (internal) configuration type (mesh or single AP) used for labelling and organization - `meta.home` (object) mobile client state - `meta.home.sens` (integer) (internal) sensitivity level - `meta.home.cooldown` (integer) (internal) cooldown time - `meta.home.sensitivity_level` (string) sensitivity level: high, normal, low - `meta.location` (object) location indicator leafs, key is leaf mac and value is location string - `meta.neuron_env` (string,null) neuron environment to be used with this network (only current dev is supported) - `meta.motion_paused` (integer) Identifies if the network is in a paused state. Only applicable for Access Points and wireless extenders. - The network is not paused. - The network is paused. - `meta.mqSecureRadarPort` (number,null) Advanced - Network level overwrite of gatekeeper's response. - `meta.auto_segment` (integer) (internal) value for internal Vision project - `meta.guardian_env` (string) value env to indicate where fusion happens (only local is currently supported) - `meta.friendly_name` (object) friendly name for leafs, key is leaf mac and value is friendly name string - `meta.new_network_id` (integer) (internal) used to indicate if there is older network id assigned to this network - `meta.old_network_id` (integer) (internal) used to indicate if the old network id assigned to this network - `meta.new_guardian_id` (string) (internal) used to indicate if there is older guardian id assigned to this network - `meta.gatekeeper_redirect` (string) Full URL of target gatekeeper (move this network to another instance) - `master_node_id` (integer, required) Unique ID of gateway or mesh root node. - `shard_id` (integer, required) Identifies the shard the network is stored in. - `guardian_type` (string, required) String representation of network's shard in shard- format. - `disconnected_at` (number) UTC second timestamp of recorded disconnection. - `nodes` (array) When expandNodes=true or in a configuration update context, the nodes part of this network are returned in this array. - `nodes.id` (integer, required) - `nodes.network_id` (integer, required) - `nodes.shard_id` (integer, required) - `nodes.created_at` (number) UTC timestamp - `nodes.updated_at` (number) UTC timestamp - `nodes.ap_bssid_2ghz` (string,null) MAC in 00:11:22:33:44:55 format - `nodes.ap_bssid_5ghz` (string,null) MAC in 00:11:22:33:44:55 format - `nodes.mesh_bssid` (string,null) MAC in 00:11:22:33:44:55 format - `nodes.deviceid` (string, required) IoT device name of Node - `nodes.devicetype` (string, required) IoT device type of Node - `nodes.token` (string, required) IoT access token - `nodes.last_heard` (number) UTC timestamp - `nodes.last_status` (object,null) Last node status (deprecated) - `nodes.connection_status` (string) Enum: "OFFLINE", "ONLINE" - `nodes.connection_report` (object) - `nodes.connection_report.ClientAddr` (string) IP Address - `nodes.connection_report.Protocol` (string) - `nodes.connection_report.Durable` (boolean) - `nodes.connection_report.ClientID` (string) Format is d:org:deviceType:deviceId - `nodes.connection_report.Time` (string) - `nodes.connection_report.Action` (string) Enum: "Connect", "Disconnect" - `nodes.connection_report.Port` (integer) - `nodes.meta` (object) Additional meta-data attached to this radar node (friendly name, etc..) - `nodes.gateway_bssid` (string,null) MAC in 00:11:22:33:44:55 format - `nodes.p2p_bssid` (string,null) MAC in 00:11:22:33:44:55 format - `id` (integer, required) Unique network integer identifier. - `connection_status` (boolean,null) Current connection status (null if has never been connected). - `device_info` (object) Mac-address keyed device info for all clients in this network.