Cisco APIC Getting Started Guide, Release 6.2(x)

PDF

Find your switch inventory using the REST API

Updated: January 12, 2026

Overview

Use this procedure to find your switch model and serial numbers using the REST API. Retrieve your switch inventory by sending a GET request to the specified URL, which returns detailed information about each switch, including model and serial numbers.

This section explains how to find your switch model and serial numbers using the REST API

Procedure

Find your switch inventory as follows:

Example:

GET https://192.0.20.123/api/node/mo/topology/pod-1.json?query-target=children&target-subtree-class=fabricNode

The following response is returned:

response: 
                        {
                        "totalCount":"8",
                        "imdata":
                        [{
                        "fabricNode":{
                        "attributes":{
                        "adSt":"on",
                        "childAction":"",
                        "delayedHeartbeat":"no",
                        "dn":"topology/pod-1/node-103",
                        "fabricSt":"active",
                        "id":"103",
                        "lcOwn":"local",
                        "modTs":"2016-10-08T14:49:35.665+00:00",
                        "model":"N9K-C9396PX",
                        "monPolDn":"uni/fabric/monfab-default",
                        "name":"leaf3",
                        "nameAlias":"",
                        "role":"leaf",
                        "serial":"TEP-1-103",
                        "status":"","uid":"0",
                        "vendor":"Cisco Systems, Inc",
                        "version":""}
                        }
                        },{
                        "fabricNode":{
                        "attributes":{
                        "adSt":"on",
                        "childAction":"",
                        "delayedHeartbeat":"no",
                        "dn":"topology/pod-1/node-105",
                        "fabricSt":"active",
                        "id":"105",
                        "lcOwn":"local",
                        "modTs":"2016-10-08T14:47:52.011+00:00",
                        "model":"N9K-C9508",
                        "monPolDn":"uni/fabric/monfab-default",
                        "name":"spine2",
                        "nameAlias":"",
                        "role":"spine",
                        "serial":"TEP-1-105","status":"",
                        "uid":"0",
                        "vendor":"Cisco Systems, Inc",
                        "version":""
                        ...
                        [TRUNCATED]
                        ...
                        }