Skip to content

get_client_stats

Report per-client traffic, signal, and uptime for one client by MAC.

Side effects: None (read-only).

Returns a record with hostname, name, ip, is_wired, network, essid, uptime, first_seen/last_seen, signal/rssi/satisfaction (wireless), tx_rate/rx_rate, tx_bytes/rx_bytes, tx_retries, anomalies, and the wired wired_rate_mbps/wired_tx_bytes/wired_rx_bytes fields when present. Returns a NOT_FOUND error envelope if the client is not currently connected.

get_client_stats(mac="aa:bb:cc:00:00:01")
ParameterTypeRequiredDefaultDescription
macstringyesMAC address of the connected client.
controllerstringno”default”Name of the UniFi controller to target. Defaults to "default".