Skip to content

Get Devices

Get the list of all devices in the SD-WAN Fabric:

Use the Bruno collection loaded during Lab Setup.

STEP1 - Select the Get Devices request

In Bruno, open the Catalyst SD-WAN collection, then open the Authentication folder and select 03 - Get Devices.

As you can see, we are re-using the XSRF Token in the header, it is required for many REST-API operations.

STEP2 - Hit send (right arrow on the top right)

STEP3 - Check response

Notice that the first section is internal and called header:

Response payload example
{
"header": {
"generatedOn": 1782742269401,
"viewKeys": {
"uniqueKey": [
"system-ip"
],
"preferenceKey": "grid-Device"
},
"columns": [
{
"title": "client.view.clientViewDevice.hostname",
"property": "host-name",
"display": "iconAndText",
"iconProperty": "device-type",
"hideable": false,
"icon": [
{
"key": "vmanage",
"value": "images/vmanage_table.png"
},
{
"key": "vedge",
"value": "images/vedge_table.png"
},
{
"key": "vedge-vbond",
"value": "images/vedge-vbond_table.png"
},
{
"key": "vsmart",
"value": "images/vsmart_table.png"
},
{
"key": "vbond",
"value": "images/vbond_table.png"
}
],
"width": 150,
"dataType": "string"
},
{
"title": "client.view.clientViewDevice.deviceModel",
"property": "device-model",
"display": "multiColumns",
"hideable": false,
"width": 100,
"dataType": "deviceModel"
},
[snip]
},
"data": [cut for brevity]
}

Collapse this header section and the actual content is under data:

Response payload example
{
"header": {cut for brevity},
"data": [
{
"deviceId": "100.0.0.1",
"system-ip": "100.0.0.1",
"host-name": "Manager01",
"reachability": "reachable",
"status": "normal",
"personality": "vmanage",
"device-type": "vmanage",
"device-groups": [
"No groups"
],
"lastupdated": 1782740756105,
"domain-id": "0",
"board-serial": "71A9AF8450E7497DB397DDD044D40AD5",
"certificate-validity": "Valid",
"max-controllers": "0",
"uuid": "2b6e4bff-5c8a-47ee-aade-2edd4a96d08e",
"controlConnections": "9",
"device-model": "vmanage",
"version": "26.1.0.04",
"connectedVManages": [
"100.0.0.1"
],
"site-id": "100",
"latitude": "37.666684",
"longitude": "-122.777023",
"isDeviceGeoData": false,
"platform": "x86_64",
"uptime-date": 1773913096098,
"statusOrder": 4,
"device-os": "next",
"validity": "valid",
"state": "green",
"state_description": "All daemons up",
"model_sku": "None",
"local-system-ip": "100.0.0.1",
"total_cpu_count": "10",
"testbed_mode": false,
"layoutLevel": 1,
"site-name": "SITE_100"
},
{
other devices...
}
}