DNAC REST API: Existing Endpoint for getting all clients and Documentation of Assurance API?

[dd.jesus.perez]

Hello everyone,

I am looking for a way to retrieve a detailed list of all clients from DNAC 1.2.10 via REST API.

A look at the Clients API of DNAC 1.2.10 revealed only two endpoints:

• https://pubhub.devnetcloud.com/media/dna-center-api-1210/docs/swagger_dnacp_1210.html#!/Clients/getClientDetail
  • where client mac is a required parameter (one call per client)
• https://pubhub.devnetcloud.com/media/dna-center-api-1210/docs/swagger_dnacp_1210.html#!/Clients/getOverallClientHealth
  • no client specific information, just overall statistics

None of those allows retrieval of a list with all clients

DNAC GUI appears to overcome this by using the "assurance" API (https://sandboxdnac.cisco.com/api/assurance/v1/host) but:

• I cannot find the assurance API Docs (are those public?)
• The list of clients in the DNAC Sandbox is empty, so I cannot analyze the retrieved object to see which client-properties are delivered by this api (the client table shown in DNAC GUI -> Assurance->Health does not display the client mac address! so even if my code can leverage the assurance api I am not sure if I will be able to use the results to allow futher requests to the  "/Clients/getClientDetail" endpoint)

Any orientation/help to get a detailed list of clients from DNAC via rest API would be much appreciated.

Thank you!

[aradford · Accepted solution]

No official API exists right now.

/host still works, but is not ideal.

[testAsim]

Is this API available/published now?

[dominiks]

no, but still works

[rsethre]

it looks like the result from dnac is limited to 500 hosts.

is there a possibility to filter the output?
something like:
/api/v1/host?hostIp=192.168.10.0/24
i get an error when i play around with ?hostIp>192.168. but the query is accepted with ?hostIp>192.168.10.0 but the result is not filtered,