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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Cisco Catalyst Center

Cisco Catalyst Center Energy API

Operations related to retrieving overall energy information for Catalyst Center Devices

Documentation Provider Profile APIs.io OpenAPI GitHub

Cisco Catalyst Center Energy 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 Energy. 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 19 operations across 17 paths, and defines 73 schemas. It is described by OpenAPI 3.2.0, at version 1.0.1.

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

19 operations 17 paths 73 schemas 11 GET8 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.1
Base URL
https://{catalyst-center-host}/dna/intent/api/v1
Contact
Cisco TAC World Wide
License
Cisco Catalyst Center License
Terms of Service
View terms
Resource Areas
1

Paths & Operations 19

Across 17 paths, the API surfaces 19 operations — 11 GET, 8 POST. Each is listed below with its method, path, parameters, and response codes.

energy 19

Operations related to retrieving overall energy information for Catalyst Center Devices

GET
/data/api/v1/energy/networkDevices
Get devices energy
readNetworkDevicesEnergy 15 params → 2004005001XX2XX3XX4XX5XX
GET
/data/api/v1/energy/clients
Get clients energy
readClientDevicesEnergy 15 params → 2004005001XX2XX3XX4XX5XX
GET
/data/api/v1/energy/networkDevices/{id}
Get device energy by ID
readNetworkDevicesEnergyById 6 params → 2004004045001XX2XX3XX4XX
GET
/data/api/v1/energy/clients/{id}
Get client energy by ID
readClientDevicesEnergyById 6 params → 2004004045001XX2XX3XX4XX
GET
/data/api/v1/energy/networkDevices/count
Count devices energy
countNetworkDevicesEnergy 9 params → 2004005001XX2XX3XX4XX5XX
GET
/data/api/v1/energy/clients/count
Count clients energy
countClientDevicesEnergy 9 params → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/networkDevices/query
Query devices energy.
queryNetworkDevicesEnergy 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/clients/query
Query clients energy
queryClientDevicesEnergy 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/networkDevices/query/count
Count devices energy from query
queryNetworkDevicesEnergyCount 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/clients/query/count
Count clients energy from query
queryClientDevicesEnergyCount 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/summaryAnalytics
Get energy summary analytics
queryDeviceEnergySummaryAnalytics 1 param body → 2004005001XX2XX3XX4XX5XX
POST
/data/api/v1/energy/trendAnalytics
Get energy trend analytics
queryDeviceEnergyTrendAnalytics 1 param body → 2004005001XX2XX3XX4XX5XX
GET
/dna/data/api/v1/energy/sites
Get sites energy
readSitesEnergy 16 params → 2002024005001XX2XX3XX4XX
GET
/dna/data/api/v1/energy/sites/{id}
Get site energy by ID
readSitesEnergyById 8 params → 2002024004045001XX2XX3XX
GET
/dna/data/api/v1/energy/sites/count
Count sites energy
countSitesEnergy 10 params → 2002024005001XX2XX3XX4XX
GET
/dna/data/api/v1/energy/sites/query
Query sites energy for the given task ID
querySitesEnergyTask 2 params → 2004005001XX2XX3XX4XX5XX
POST
/dna/data/api/v1/energy/sites/query
Submit request to query sites energy
querySitesEnergy 1 param body → 2024005001XX2XX3XX4XX5XX
GET
/dna/data/api/v1/energy/sites/query/count
Count sites energy for the given task ID
querySitesEnergyCountTask 2 params → 2004005001XX2XX3XX4XX5XX
POST
/dna/data/api/v1/energy/sites/query/count
Submit request to count sites energy from query
querySitesEnergyCount 1 param body → 2024005001XX2XX3XX4XX5XX

Schemas 73

The contract defines 73 schemas that model the data the API accepts and returns. The most detailed are DeviceEnergy (22 properties), SiteEnergy (13 properties), DeviceEnergyTrendAnalyticsRequest (6 properties), NetworkDeviceEnergyFilter (5 properties). Each schema is shown below with its type and property counts.

NetworkDeviceEnergyAttribute
string
Field names which are supported by this API as attributes.
SiteEnergyAggregateAttributesResponse
array
SitesEnergyResponse
object
3 properties
CountIntegerResponse_response
object
1 property
ClientDeviceEnergyResponse
object
2 properties
SiteEnergyAggregateAttributeKey
string
Field name on which the aggregate function should be applied when querying the data. The fields supported for aggregation in the API response object are, [ener…
SiteEnergyView
string
Views which are supported by this API. Each view represents a specific data set. Response data provided by each view: 1. Site [id, siteHierarchy, siteHierarchy…
ErrorObject
object
3 properties
DeviceEnergySortByObj
object
This is a unified sortBy model for attributes and aggregate attributes request. If function is specified then API will sort the collection on aggregated attrib…
3 properties
ClientDevicesEnergyResponse
object
3 properties
ErrorResponse
object
Contains information explaining the error that occured processing this request.
2 properties
ClientDevicesEnergyQueryResponse
object
3 properties
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
NetworkDeviceEnergySortByObj
object
This is a unified sortBy model for attributes and aggregate attributes request. If function is specified then API will sort the collection on aggregated attrib…
3 properties
NetworkDeviceEnergyResponse
object
2 properties
ClientDeviceEnergy
object
Assurance Client Device Energy Summaries details
3 properties
DevicesEnergyAggregateAttribute
object
Aggregate attribute object for device energy summaries. Name and function supported are in their respective enum objects.
2 properties
DeviceEnergySummaryAnalyticsResponse
object
3 properties
NetworkDeviceEnergyFilter
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
DeviceEnergyAttributesResponse_inner
object
2 properties
DeviceEnergy
object
Assurance Device Energy Summaries details
22 properties
DeviceEnergySummaryAnalyticsRequest
object
Request object for device summary analytics.
5 properties
NetworkDevicesEnergyQueryResponse
object
3 properties
LogicalOperator
string
Operator to use when attempting to apply a logical conjunction of more than 1 filter Logical operations include: 'and', 'or'.
ClientDeviceEnergyFilters
array
List of filters to apply when querying the device energy data. Supported operators are [in, eq, like]
SiteEnergyFilter
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
DeviceEnergyFilters
array
List of filters to apply when querying the device energy data. Supported operators are [in, eq, like]
DeviceEnergyFilterKey
string
Field names which are supported by this API for filter keys.
ClientDeviceEnergyPaginationWithAggregateSortBy
object
Pagination model with support for aggregate sort by.
4 properties
NetworkDeviceEnergyPaginationWithAggregateSortBy
object
Pagination model with support for aggregate sort by.
4 properties
DeviceEnergyResponse_groups
object
3 properties
DeviceEnergyTrendInterval
string
The time window to aggregate the metrics. Interval can be 1 hour or 1 day.
SiteEnergyResponse
object
2 properties
DeviceEnergyPaginationWithAggregateSortBy
object
Pagination model with support for aggregate sort by.
4 properties
NetworkDeviceEnergyFilters
array
List of filters to apply when querying the device energy data. Supported operators are [in, eq, like]
DeviceEnergyTrendAnalyticsResponse
object
3 properties
DeviceEnergyResponse
object
Response object for device summary analytics.
3 properties
SitesEnergyQueryRequest
object
5 properties
asyncInfoContainer
object
Generic model that will contain the asynchronous task/process information
2 properties
SitesEnergyQueryResponse
object
3 properties
DeviceEnergyAttribute
string
Field names which are supported by this API as attributes.
asyncInfo
object
Generic model with information on the asynchronous task/process that was created to handle an API request
2 properties
NetworkDeviceEnergy
object
Assurance Network Device Energy Summaries details
1 property
CountIntegerResponse
object
Reports
2 properties
SiteEnergyFilters
array
List of filters to apply when querying the site energy data. Supported operators are [in, eq, like]
SiteEnergyAggregateAttribute
object
2 properties
ClientDeviceEnergyFilter
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
Function
string
Type of aggregate function to apply on the field when querying data
ClientDeviceEnergyQueryRequest
object
Request object for device energy summaries query request.
5 properties
DeviceEnergyAttributesResponse
array
Response object for device summary analytics attributes.
TrendPaginationResponse
object
Pagination response object for trend analytics.
4 properties
SiteEnergy
object
Assurance site and corresponding energy details
13 properties
ClientDeviceEnergyAttribute
string
Field names which are supported by this API as attributes.
DeviceEnergyGroupBy
array
List of group by supported. GroupBy should be in a specific sequence ex - deviceCategory, deviceSubCategory and not deviceSubCategory, deviceCategory
SiteEnergyAttribute
string
Field names which are supported by this API as attributes or filter keys
ClientDeviceEnergySortByObj
object
This is a unified sortBy model for attributes and aggregate attributes request. If function is specified then API will sort the collection on aggregated attrib…
3 properties
Operator
string
Type of filter operator to use for querying data | in and out operator takes multiple values and applies the filters
DeviceEnergyAggregateAttributesResponse_inner
object
3 properties
DeviceEnergyAggregateAttributeKey
string
Field name on which the aggregate function should be applied when querying the data. The fields supported for aggregation in the API response object are, [ener…
NetworkDevicesEnergyResponse
object
3 properties
SiteEnergySortByObj
object
This is a unified sortBy model for attributes and aggregate attributes request. If function is specified then API will sort the collection on aggregated attrib…
3 properties
DeviceEnergyAggregateAttributesResponse
array
Response object for device energy aggregate attributes.
ClientDeviceEnergyView
string
Views which are supported by this API. Each view represents a specific data set. Response data provided by each view: 1. device [id, deviceId, deviceCategory,…
SiteEnergyPaginationWithAggregateSortBy
object
Pagination model with support for aggregate sort by.
4 properties
NetworkDeviceEnergyView
string
Views which are supported by this API. Each view represents a specific data set. Response data provided by each view: 1. device [id, deviceId, deviceCategory,…
SiteEnergyFilterKey
string
Field names which are supported by this API for filter keys.
DeviceEnergyFilter
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
ClientDeviceEnergyFilterKey
string
Field names which are supported by this API for filter keys.
NetworkDeviceEnergyFilterKey
string
Field names which are supported by this API for filter keys.
TrendPaginationRequest
object
Pagination request object for trend analytics.
3 properties
NetworkDeviceEnergyQueryRequest
object
Request object for device energy summaries query request.
5 properties
SiteEnergyAggregateAttributesResponse_inner
object
3 properties
DeviceEnergyTrendAnalyticsRequest
object
Request object for device energy summaries trend analytics.
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Cisco Catalyst Center publishes across the network.

Cisco Catalyst Center MCP Server
AE Profile APIs.io
Cisco Catalyst Center AAA Services API
AE Profile APIs.io
Cisco Catalyst Center Application Health Score Definitions API
AE Profile APIs.io
Cisco Catalyst Center Assurance Events API
AE Profile APIs.io
Cisco Catalyst Center Assurance Tasks API
AE Profile APIs.io
Cisco Catalyst Center Clients API
AE Profile APIs.io
Cisco Catalyst Center Custom Issue Definitions API
AE Profile APIs.io
Cisco Catalyst Center DHCP Services API
AE Profile APIs.io
Cisco Catalyst Center Direct Deploy API
AE Profile APIs.io
Cisco Catalyst Center DNS Services API
AE Profile APIs.io
Cisco Catalyst Center Fabric Site Health Summaries API
AE Profile APIs.io
Cisco Catalyst Center Fabric Summary API
AE Profile APIs.io
#Energy
← Back to C APIs
API Details
ID
cisco-catalyst-center:cisco-catalyst-center-energy-api
Base URL
https://{catalyst-center-host}/dna/intent/api/v1
Docs
https://developer.cisco.com/docs/catalyst-center/
Provider
Cisco Catalyst Center
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=cisco-catalyst-center-energy-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/cisco-catalyst-center-energy-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Cisco Catalyst Center Energy 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.