searchSiteWirelessClients

GET https://{{host}}/api/v1/sites/:site_id/clients/search

Request

NameTypeDescription
macstringpartial / full MAC address
hostnamestringpartial / full hostname
devicestringdevice type, e.g. Mac, Nvidia, iPhone
osstringos, e.g. Sierra, Yosemite, Windows 10
modelstringmodel, e.g. “MBP 15 late 2013”, 6, 6s, “8+ GSM”
apstringAP mac where the client has connected to
ssidstringSSID
textstringpartial / full MAC address, hostname, username, psk_name or ip
psk_idstringPSK ID
psk_namestringPSK name
nacrule_idstringnacrule_id

NOTE: fuzzy logic can be used with ‘’, supported filters: mac, hostname, device, os, model. E.g. `/clients/search?device=Mac&hostname=jerry`

Request Params

KeyDatatypeRequiredDescription
macnullpartial / full MAC address
hostnamenullpartial / full hostname
devicenulldevice type, e.g. Mac, Nvidia, iPhone
osnullos, e.g. Sierra, Yosemite, Windows 10
modelnullmodel, e.g. “MBP 15 late 2013”, 6, 6s, “8+ GSM”
apnullAP mac where the client has connected to
ssidnullSSID
textnullpartial / full MAC address, hostname, username, psk_name or ip
psk_idnullPSK ID
psk_namenullPSK name
nacrule_idnullnacrule_id

RESPONSES

status: OK

{"results":[{"hostname":["jerry"],"ap":["5c5b350e0492","5c5b350eb39d","5c5b350e03c0"],"ip":["192.168.5.43","192.168.20.125"],"vlan":[1],"mac":"60f81dd250cc","device":["Mac"],"os":["Sierra","High Sierra"],"model":["","MBP 15\" late 2013"],"ssid":["Guest"]}]}