When accessing the /device-detail endpoint in cisco DNA Center, what is an acceptable searchBy parameter value?

According to the official Cisco DNA Center Intent API documentation, the GET /dna/intent/api/v1/device-detail endpoint is used to retrieve detailed information about a specific device. This endpoint requires two query parameters: searchBy and identifier. The searchBy parameter specifies the attribute to use for the search, and the documentation explicitly lists "MAC Address", "device id", or "device name" as the only valid values. Therefore, "MAC address" is an acceptable value for this parameter.

A. Platform type is not a supported value for the searchBy parameter in this specific API endpoint.
B. IP address is not a valid value for the searchBy parameter; other API calls might use IP, but not this one.
C. Software version is not a valid search criterion for the searchBy parameter as per the API specification.

1. Cisco DNA Center Platform API Reference

Devices > Get Device Detail. Cisco Developer. Accessed [Current Date].

Reference Details: In the documentation for the GET /dna/intent/api/v1/device-detail endpoint

under the "Query Parameters" section

the description for the searchBy parameter states: "MAC Address or device id or device name of the device to be searched". This directly confirms that "MAC address" is a valid option.

URL: https://developer.cisco.com/docs/dna-center/#!get-device-detail