How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco Catalyst Center Network Devices API

Operations related to Catalyst Center - Gets the Network Device details

Cisco Catalyst Center Network Devices API is one of 30 APIs that Cisco Catalyst Center publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Network Devices. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, and authentication docs.

This API exposes 9 operations across 9 paths, and defines 84 schemas. It is described by OpenAPI 3.2.0, at version 3.1.5.

Requests are made against a single base URL, https://developer.cisco.com/data/api/v1.

9 operations 9 paths 84 schemas 3 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.1.5
Base URL
https://{catalyst-center-host}/dna/intent/api/v1
Terms of Service
Resource Areas
1

Paths & Operations 9

Across 9 paths, the API surfaces 9 operations — 3 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

networkDevices 9

Operations related to Catalyst Center - Gets the Network Device details

GET
/networkDevices
Gets the Network Device details based on the provided query parameters.
readNetworkDevices 25 params → 2004005001XX2XX3XX4XX5XX
GET
/networkDevices/count
Gets the total Network device counts based on the provided query parameters.
readNetworkDevicesCount 19 params → 2004005001XX2XX3XX4XX5XX
GET
/networkDevices/{id}
Get the device data for the given device id (Uuid)
readNetworkDeviceById 5 params → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/{id}/trendAnalytics
The Trend analytcis data for the network Device in the specified time range
readDeviceTrendAnalytics 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/query
Gets the list of Network Devices based on the provided complex filters and aggregation functions.
queryNetworkDevicesWithFilter body → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/query/count
Gets the total number Network Devices based on the provided complex filters and aggregation functions.
queryNetworkDevicesCountWithFilter body → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/summaryAnalytics
Gets the summary analytics data related to network devices.
queryNetworkDevicesSummaryAnalytics body → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/topNAnalytics
Gets the Top-N analytics data.
queryNetworkDevicesTopNAnalytics body → 2004005001XX2XX3XX4XX5XX
POST
/networkDevices/trendAnalytics
Gets the Trend analytics data.
queryNetworkDevicesTrendAnalytics body → 2004005001XX2XX3XX4XX5XX

Schemas 84

The contract defines 84 schemas that model the data the API accepts and returns. The most detailed are CommonDetails (40 properties), FabricHealth (34 properties), ApConfigurationDetails (30 properties), MetricsDetails (28 properties). Each schema is shown below with its type and property counts.

NetworkDevicesAnalyticsAttributes
array
List of field names on which the aggregate function should be applied
NetworkDevicesSummaryFilter
object
In case of single filter, please use key, operator and value combination. If multiple filters need to be applied using a logical operation, please use logicalO…
5 properties
AggregateSortBy
object
Records are sorted based on the fields specified in the array.
3 properties
NetworkDeviceResponseWithAggregate
object
1 property
NetworkDeviceTrendGroupResponse
object
Network Device metric Trend Analytics Response
3 properties
ApAfcDetails
object
AFC response attributes of an Access Point (AP)
9 properties
NetworkDevicesTrendResponse
object
Network Devices Trend Analytics Response
3 properties
CommonDetails
object
40 properties
WlcApLicenses
object
AP Licenses in-use counts of a network device
6 properties
CountIntegerResponse_response
object
1 property
NetworkDeviceTrendResponse
object
4 properties
NetworkDeviceTrendAttribute
string
Network device Trend attributes details
NetworkDeviceView
string
Views which are supported by this API. Each view represents a specific data set. When no views are requested, the default information fetched is the configurat…
NetworkDevicesTrendRequest
object
The input payload schema to query the Trend Analytics Network Device data.
6 properties 1 required
NetworkDevicesAnalyticsGroupResponse
object
3 properties
ErrorObject
object
3 properties
NetworkDevicesQueryRequest
object
5 properties
ErrorResponse
object
Contains information explaining the error that occured processing this request.
2 properties
NetworkDevicesAnalyticsFilters
array
List of filters to apply when querying the Network devices data. Supported operators are [in, eq, neq, notIn, like] When using filters, the request must contai…
startAndEndTime
object
start and end time of data set to query. Data is aggregated based on time window and timestamped with window start time. | For example - 1. When data events fa…
2 properties
TrendIntervalInMinutes
integer
the trend data time interval in minutes. This is a mandatory property. The possible values are 5, 10, 30, 60. When the start and end Time range is greater than…
FabricDetails
object
7 properties
PaginationWithAggregateSortBy
object
Reference to pagination properties
4 properties
NetworkDevicesAnalyticsGroupResponse_groups
object
3 properties
NetworkDeviceFilters
array
List of filters to apply when querying the Network devices data. Supported operators are [in, eq, neq, notIn, like]
NetworkDevicesPagination
object
5 properties
NetworkDeviceTrendFilters
array
When using filters, the request must contain only fields from the same grouping (across all request fields) | Group | Valid Fields | | --- | --- | | HealthScor…
NetworkDeviceViews
array
The List of Network Device model views. Please refer to NetworkDeviceView for the supported list
NetworkDeviceFilter
object
In case of single filter, please use key, operator and value combination. If multiple filters need to be applied using a logical operation, please use logicalO…
5 properties
NetworkDeviceTrendAttributeResponse_inner
object
2 properties
LogicalOperator
string
Operator to use when attempting to apply a logical conjunction of more than 1 filter Logical operations include: 'and', 'or'.
ApConfigurationDetails
object
30 properties
NetworkDevicesAnalyticsAttributesResponse
array
NetworkDevicesTopNAnalyticsGroupResponse
object
1 property
AggregateResponseAttributes
object
3 properties
RadioKpis
array
NetworkDevicesSummaryAttribute
string
The network device summary attributes
NetworkDevice
object
Network Devices details with health and configuration
8 properties
MetricsDetails
object
28 properties
NetworkDevicesAnalyticsAggregatesResponse
array
NetworkDeviceResponse
object
2 properties
NetworkDeviceAttribute
string
Field names which are supported by this API as attributes or filter keys
Pagination_sortBy
object
List of field names and corresponding order used to sort the records.
2 properties
NetworkDevicesTrendAnalyticsGroupResponse
object
4 properties
NetworkDevicesSummaryRequest
object
5 properties
DeviceBasic
object
3 properties
NetworkDevicesAnalyticsAggregateName
string
Field name on which the aggregate function should be applied when querying the data. The supported field details are available in the enum definition.
NetworkDevicesAnalyticsAggregateResponse
object
3 properties
NetworkDevicesTopNAnalyticsGroupResponse_groups
object
3 properties
CountIntegerResponse
object
Reports
2 properties
NetworkDeviceTrendAttributeResponse
array
NetworkDeviceTrendResponse_groups
object
3 properties
NetworkDevicesSummaryFilterKey
string
Summary filter support key name
NetworkDeviceTrendRequest
object
NetworkDeviceTrendRequest
8 properties 1 required
NetworkDevicesAnalyticsAggregateAttributes
object
2 properties
NetworkDeviceTrendAggregateFields
string
Field name on which the aggregate function should be applied while querying the data.
Function
string
The name of the aggregate function
RadioKpi
object
12 properties
TrendPaginationResponse
object
4 properties
LicenseDetails
object
License attributes of a network device
3 properties
NetworkDevicesAnalyticsAttributesResponse_inner
object
2 properties
NetworkDeviceAttributes
array
The List of Network Device model attributes. This is helps to specificy the intrested fields in the request
NetworkDeviceAggregateAttributes
object
2 properties
Operator
string
Type of filter operator to use for querying data | in and out operator takes multiple values and applies the filters
SwitchPoEDetails
object
14 properties
endTime
integer
End time to which the API queries the dataset related to the resource. It must be specified in terms of milliseconds since UNIX epoch. Value is inclusive.
NetworkDevicesResponse
object
3 properties
NetworkDeviceTrendFilter
object
In case of single filter, please use key, operator and value combination. If multiple filters need to be applied using a logical operation, please use logicalO…
5 properties
NetworkDevicesAnalyticsGroupBy
array
List of field names on which the Group By function should be applied
FabricHealth
object
34 properties
NetworkDeviceTrendAggregateAttribute
object
Attribute on which the aggregate function should be applied while querying the data.
2 properties
NetworkDeviceAggregateAttributeResponse
object
1 property
NetworkDevicesTrendAnalyticsGroupResponse_groups
object
3 properties
NetworkDeviceTrendResponseAggregate
object
1 property
NetworkDevicesTopNRequest
object
The input payload schema to query Top-N Analytics Network Device data.
6 properties 2 required
NetworkDevicesAnalyticsResponse
object
Network Devices Trend Analytics Response
3 properties
NetworkDeviceAggregateAttributesName
string
Field name on which the aggregate function should be applied when querying the data. The supported field details are available in the enum definition.
Pagination
object
3 properties
NetworkDeviceTrendGroupBy
array
NetworkDeviceTrendAggregateAttributes
array
List of Attributes on which the aggregate function should be applied while querying the data.
NetworkDevicesTopNAnalyticsResponse
object
Network Devices Trend Analytics Response
3 properties
startTime
integer
Start time from which the API queries the dataset related to the resource. It must be specified in terms of milliseconds since UNIX epoch. Value is inclusive.
TrendPaginationRequest
object
The reference for Pagination trend request.
3 properties
ModuleDetails
object
13 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-catalyst-center-networkdevices-api-openapi.yml Raw ↑

Other APIs Cisco Catalyst Center publishes across the network.

Cisco Catalyst Center MCP Server
Cisco Catalyst Center AAA Services API
Cisco Catalyst Center Application Health Score Definitions API
Cisco Catalyst Center Assurance Events API
Cisco Catalyst Center Assurance Tasks API
Cisco Catalyst Center Clients API
Cisco Catalyst Center Custom Issue Definitions API
Cisco Catalyst Center DHCP Services API
Cisco Catalyst Center Direct Deploy API
Cisco Catalyst Center DNS Services API
Cisco Catalyst Center Energy API
Cisco Catalyst Center Fabric Site Health Summaries API
Where this information came from

This is an independent, third-party profile of Cisco Catalyst Center Network Devices API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.