Cisco APIC Installation and ACI Upgrade and Downgrade Guide

Verify the firmware version and the upgrade status using the API

Updated: July 12, 2026

Want to summarize with AI?

Describes the API methods for retrieving current firmware versions on controllers and switches, as well as the status of upgrade jobs. This information assists administrators in monitoring system maintenance tasks.

This reference provides the specific GET URLs required to query firmware running versions and upgrade job statuses via the API.


Verification Description	Example URL
For the current running firmware version on controllers	GET URL: https://<ip address>/api/node/class/firmwareCtrlrRunning.xml
For the currently operating firmware version on switches	GET URL: https://<ip address>/api/node/class/firmwareRunning.xml
For the upgrade status of controllers and switches	GET URL: https://<ip address>/api/node/class/maintUpgJob.xml

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.