Fetch a list of devices in the CDO tenant
GET {{baseUrl}}/v1/inventory/devices?limit=50&offset=0&q=<string>&sort=<string>&sort=<string>
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
limit | number | The number of results to retrieve. | |
offset | number | The offset of the results retrieved. The CDO Public API uses the offset field to determine the index of the first result retrieved, and will retrieve limit results from the offset specified. | |
q | string | The query to execute. Use the Lucene Query Syntax to construct your query. | |
sort | string | The fields to sort results by. | |
sort | string | The fields to sort results by. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"count":"\u003cinteger\u003e","limit":"\u003cinteger\u003e","offset":"\u003cinteger\u003e","items":[{"deviceType":"ONPREM_FMC","name":"\u003cstring\u003e","uid":"\u003cuuid\u003e","connectorType":"CDG","connectorUid":"\u003cuuid\u003e","address":"\u003cstring\u003e","deviceRole":"ZTNA_PROVIDER","serial":"\u003cstring\u003e","chassisSerial":"\u003cstring\u003e","softwareVersion":"\u003cstring\u003e","connectivityState":"UNREACHABLE","configState":"NO_CONFIG","conflictDetectionState":"NO_CONFLICTS","notes":"\u003cstring\u003e","asdmVersion":"\u003cstring\u003e","asaFailoverMode":"ACTIVE_STANDBY","asaFailoverState":"\u003cstring\u003e","asaFailoverMate":{"failoverState":"\u003cstring\u003e","serial":"\u003cstring\u003e","softwareVersion":"\u003cstring\u003e"},"asaLicenseEntitlements":{"laboris_89":"\u003cstring\u003e"},"ftdLicenses":["\u003cstring\u003e","\u003cstring\u003e"],"snortVersion":"\u003cstring\u003e","ftdPerformanceTier":"\u003cstring\u003e","cdFmcInfo":{"cliKey":"\u003cstring\u003e","regKey":"\u003cstring\u003e","natId":"\u003cstring\u003e"},"onPremFmcInfo":{"name":"\u003cstring\u003e","address":"\u003cstring\u003e"},"merakiDeploymentMode":"ROUTED","merakiNetwork":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","timezone":"\u003cstring\u003e"},"state":"\u003cstring\u003e","stateMachineDetails":{"identifier":"\u003cstring\u003e","lastError":{"errorMessage":"\u003cstring\u003e","errorCode":"\u003cstring\u003e","actionIdentifier":"\u003cstring\u003e"}},"labels":{"groupedLabels":{"ex_e":["\u003cstring\u003e","\u003cstring\u003e"]},"ungroupedLabels":["\u003cstring\u003e","\u003cstring\u003e"]}},{"deviceType":"SSH_DEVICE","name":"\u003cstring\u003e","uid":"\u003cuuid\u003e","connectorType":"SDC","connectorUid":"\u003cuuid\u003e","address":"\u003cstring\u003e","deviceRole":"MFA_PROVIDER","serial":"\u003cstring\u003e","chassisSerial":"\u003cstring\u003e","softwareVersion":"\u003cstring\u003e","connectivityState":"UNKNOWN","configState":"UNKNOWN","conflictDetectionState":"NO_CONFLICTS","notes":"\u003cstring\u003e","asdmVersion":"\u003cstring\u003e","asaFailoverMode":"OFF","asaFailoverState":"\u003cstring\u003e","asaFailoverMate":{"failoverState":"\u003cstring\u003e","serial":"\u003cstring\u003e","softwareVersion":"\u003cstring\u003e"},"asaLicenseEntitlements":{"veniam_9b":"\u003cstring\u003e","sint9_4":"\u003cstring\u003e","irure_f9":"\u003cstring\u003e"},"ftdLicenses":["\u003cstring\u003e","\u003cstring\u003e"],"snortVersion":"\u003cstring\u003e","ftdPerformanceTier":"\u003cstring\u003e","cdFmcInfo":{"cliKey":"\u003cstring\u003e","regKey":"\u003cstring\u003e","natId":"\u003cstring\u003e"},"onPremFmcInfo":{"name":"\u003cstring\u003e","address":"\u003cstring\u003e"},"merakiDeploymentMode":"PASSTHROUGH","merakiNetwork":{"id":"\u003cstring\u003e","name":"\u003cstring\u003e","timezone":"\u003cstring\u003e"},"state":"\u003cstring\u003e","stateMachineDetails":{"identifier":"\u003cstring\u003e","lastError":{"errorMessage":"\u003cstring\u003e","errorCode":"\u003cstring\u003e","actionIdentifier":"\u003cstring\u003e"}},"labels":{"groupedLabels":{"labore_0":["\u003cstring\u003e","\u003cstring\u003e"],"reprehenderit_982":["\u003cstring\u003e","\u003cstring\u003e"]},"ungroupedLabels":["\u003cstring\u003e","\u003cstring\u003e"]}}]}