searchSiteDevices

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

Filter Options

ParameterTypeDescription
hostnamestringpartial / full hostname
site_idstringsite id
modelstringdevice model
macstringAP mac
versionstringversion
ipstringip address
mxtunnel_statusstringMxTunnel status, up / down
mxedge_idstringMist Edge id, if AP is connecting to a Mist Edge
lldpsystemnamestringLLDP system name
lldpsystemdescstringLLDP system description
lldpportidstringLLDP port id
lldpmgmtaddrstringLLDP management ip address
sortstringsort options, timestamp/mac/model/sku, -prefix represents DESC order, default is -timestamp
statsbooleanwhether to return device stats, default is false

NOTE: fuzzy logic can be used with ā€˜ā€™, supported filters: mac, hostname, device, os, model. E.g. /clients/search?device=Mac&hostname=jerry

RESPONSES

status: OK

{"results":[{"mac":"5c5b35000001","model":"AP41-WW","ip":"192.168.1.2","version":"apfw-0.5.16833-ellaria-0455","uptime":1575742,"org_id":"2818e386-8dec-2562-9ede-5b8a0fbbdc71","site_id":"4ac1dcf4-9d8b-7211-65c4-057819f0862b","lldp_system_name":"ME-DC2-ACC-SW","lldp_system_desc":"Cisco IOS Software, Version 12.2(55)SE5, ...","lldp_port_desc":"GigabitEthernet3/0/28","lldp_mgmt_addr":"192.168.1.15","lldp_chassis_id":"63:68:61:73:73:69"}]}