{"type":"api","title":"Get Client Detail","meta":{"id":"/apps/pubhub/media/dna-center-235/0e427c513038595590fc5a0593cb0e208dd78571/2192edf3-d24e-3461-ab8c-12a97b547df4","swagger":"2.0","info":{"description":"Cisco DNA Center Platform v. 2.3.5","version":"2.3.5","title":"Intent API"},"schemes":["https"],"x-parser-conf":{"expand":0,"labelConfig":{"endpoint":"summary"}}},"spec":{"operationId":"getClientDetail","tags":["Clients"],"summary":"Get Client Detail","description":"Returns detailed Client information retrieved by Mac Address for any given point of time. ","consumes":["application/json"],"produces":["application/json"],"parameters":[{"name":"timestamp","description":"Epoch time(in milliseconds) when the Client health data is required","default":"","required":false,"type":"string","in":"query"},{"name":"macAddress","description":"MAC Address of the client","default":"","required":true,"type":"string","in":"query"}],"responses":{"200":{"description":"The request was successful. The result is contained in the response body.","schema":{"type":"object","properties":{"detail":{"type":"object","properties":{"id":{"type":"string"},"connectionStatus":{"type":"string"},"hostType":{"type":"string"},"userId":{"type":"object","properties":{}},"hostName":{"type":"string"},"hostOs":{"type":"object","properties":{}},"hostVersion":{"type":"object","properties":{}},"subType":{"type":"string"},"lastUpdated":{"type":"integer"},"healthScore":{"type":"array","items":{"type":"object","properties":{"healthType":{"type":"string"},"reason":{"type":"string"},"score":{"type":"integer"}}}},"hostMac":{"type":"string"},"hostIpV4":{"type":"string"},"hostIpV6":{"type":"array","items":{"type":"string"}},"authType":{"type":"string"},"vlanId":{"type":"string"},"vnid":{"type":"string"},"ssid":{"type":"string"},"frequency":{"type":"string"},"channel":{"type":"string"},"apGroup":{"type":"object","properties":{}},"location":{"type":"object","properties":{}},"clientConnection":{"type":"string"},"connectedDevice":{"type":"array","items":{"type":"object"}},"issueCount":{"type":"number"},"rssi":{"type":"string"},"avgRssi":{"type":"object","properties":{}},"snr":{"type":"string"},"avgSnr":{"type":"object","properties":{}},"dataRate":{"type":"string"},"txBytes":{"type":"string"},"rxBytes":{"type":"string"},"dnsSuccess":{"type":"object","properties":{}},"dnsFailure":{"type":"object","properties":{}},"onboarding":{"type":"object","properties":{"averageRunDuration":{"type":"object","properties":{}},"maxRunDuration":{"type":"object","properties":{}},"averageAssocDuration":{"type":"object","properties":{}},"maxAssocDuration":{"type":"object","properties":{}},"averageAuthDuration":{"type":"object","properties":{}},"maxAuthDuration":{"type":"object","properties":{}},"averageDhcpDuration":{"type":"object","properties":{}},"maxDhcpDuration":{"type":"object","properties":{}},"aaaServerIp":{"type":"string"},"dhcpServerIp":{"type":"object","properties":{}},"authDoneTime":{"type":"object","properties":{}},"assocDoneTime":{"type":"object","properties":{}},"dhcpDoneTime":{"type":"object","properties":{}},"assocRootcauseList":{"type":"array","items":{"type":"object"}},"aaaRootcauseList":{"type":"array","items":{"type":"object"}},"dhcpRootcauseList":{"type":"array","items":{"type":"object"}},"otherRootcauseList":{"type":"array","items":{"type":"object"}}}},"clientType":{"type":"string"},"onboardingTime":{"type":"object","properties":{}},"port":{"type":"object","properties":{}},"iosCapable":{"type":"boolean"}}},"connectionInfo":{"type":"object","properties":{"hostType":{"type":"string"},"nwDeviceName":{"type":"string"},"nwDeviceMac":{"type":"string"},"protocol":{"type":"string"},"band":{"type":"string"},"spatialStream":{"type":"string"},"channel":{"type":"string"},"channelWidth":{"type":"string"},"wmm":{"type":"string"},"uapsd":{"type":"string"},"timestamp":{"type":"integer"}}},"topology":{"type":"object","properties":{"nodes":{"type":"array","items":{"type":"object","properties":{"role":{"type":"string"},"name":{"type":"string"},"id":{"type":"string"},"description":{"type":"string"},"deviceType":{"type":"string"},"platformId":{"type":"object","properties":{}},"family":{"type":"object","properties":{}},"ip":{"type":"string"},"softwareVersion":{"type":"object","properties":{}},"userId":{"type":"object","properties":{}},"nodeType":{"type":"string"},"radioFrequency":{"type":"object","properties":{}},"clients":{"type":"object","properties":{}},"count":{"type":"object","properties":{}},"healthScore":{"type":"integer"},"level":{"type":"number"},"fabricGroup":{"type":"object","properties":{}},"connectedDevice":{"type":"object","properties":{}}}}},"links":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string"},"linkStatus":{"type":"string"},"label":{"type":"array","items":{"type":"string"}},"target":{"type":"string"},"id":{"type":"object","properties":{}},"portUtilization":{"type":"object","properties":{}}}}}}}},"$$ref":"#/definitions/GetClientDetailResponse"}},"400":{"description":"The client made a request that the server could not understand (for example, the request syntax is incorrect)."},"401":{"description":"The client's authentication credentials included with the request are missing or invalid."},"404":{"description":"The client made a request for a resource that does not exist."},"500":{"description":"The server could not fulfill the request."}},"__originalOperationId":"getClientDetail","method":"get","path":"/dna/intent/api/v1/client-detail"}}