openapi: 3.2.0 info: title: Monitoring and Troubleshooting Real-Time Monitoring - System API description: "Includes API operations for the following:\n Real-time monitoring\n Accessing statistics APIs and statistics bulk APIs\n Retrieving device state\n Managing alarms and events" contact: email: vmanage@cisco.com license: name: Commercial License url: https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html version: 26.1.0+2026-01-06 x-provenance: method: harvested authored_by: Cisco Catalyst SD-WAN harvested_by: API Evangelist harvested_on: '2026-08-19' first_party: true provider_published: true source_host: pubhub.devnetcloud.com note: 4,138 operations across 2,841 paths, published by Cisco as self-contained per-operation OpenAPI 3.1.0 fragments on the DevNet CDN and consolidated here into 13 documents. Ownership verified from info.contact vmanage@cisco.com and the Cisco license URL rather than from the fetch host. x-evidence: - type: source url: https://pubhub.devnetcloud.com/media/cisco-catalyst-sd-wan-26-1-api-guide/docs/ - type: source url: https://developer.cisco.com/docs/sdwan/ servers: - url: /dataservice tags: - name: Real-Time Monitoring - System paths: /device/csp/system/native: get: tags: - Real-Time Monitoring - System description: Get device system native settings from device operationId: createDeviceSystemSettingNativeInfo parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system native settings: description: Device system native settings value: data: - vdevice-name: 172.16.255.15 vdevice-host-name: vm5 interface: ge0/0 ipv4_address: 192.168.2.1 vdevice-dataKey: 172.16.255.15 netmask: 255.255.255.0 mac_address: 00:05:ad:00:10:41 mtu: '1500' txqueuelen: '16' lastupdated: 1661501479353 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/csp/system/processlist: get: tags: - Real-Time Monitoring - System description: Get device system process list from device operationId: createDeviceSystemProcessList parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system process list: description: Device system process list value: data: - vdevice-name: 172.16.255.15 vdevice-host-name: vm5 pid: '1' cpu: '3.5' mem: 1,6 vsz: '192156' rss: '7424' start: Wed16 time: '0:00.02' vdevice-dataKey: 172.16.255.15 cmd: systemd lastupdated: 1661501479353 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/csp/system/settings: get: tags: - Real-Time Monitoring - System description: Get device system settings from device operationId: createDeviceSystemSetting parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system settings: description: Device system settings value: data: - vdevice-name: 172.16.255.15 vdevice-host-name: vm5 interface: ge0/0 ipv4_address: 192.168.30.163 ipv4_netmask: 255.255.255.0 ipv4_dhcp: enabled ipv4_expire: '-' global_ipv6_address: fe80::72db:98ff:fe07:1f35 global_prefixlen: '0' link_local_ipv6_address: fe80::72db:98ff:fe07:1f35 link_local_prefixlen: '0' ipv6_dhcp: enabled ipv6_slaac: disabled vdevice-dataKey: 172.16.255.15 ipv6_dhcp_state: Stateful lastupdated: '1661501479353' '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/csp/system/status: get: tags: - Real-Time Monitoring - System description: Get device system status from device operationId: createDeviceSystemStatus parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system status: description: Device system status value: data: - vdevice-name: 172.16.255.15 vdevice-host-name: vm5 name: wan-br status: OK vdevice-dataKey: 172.16.255.15 type: default-bridge lastupdated: 1661501479353 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/system/clock: get: tags: - Real-Time Monitoring - System description: Get device system clock operationId: getDeviceSystemClock parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system clock: description: Device system clock value: data: - current_date/date-time-string: Tue Mar 15 16:46:40 UTC 2022 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/system/info: get: tags: - Real-Time Monitoring - System description: Get device information list operationId: createDeviceInfoList parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: type: array description: List of device IPs example: - 169.254.10.10 - 169.254.10.11 items: type: string description: Device IP example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device info: description: Device info value: data: - device-model: vedge-cloud statusOrder: 4 total_cpu_count: '2' max-controllers: '0' groupId: - none certificate-not-valid-before: Jan 29 00:19:35 2022 GMT fp_cpu_count: '1' deviceId: 169.254.10.10 uuid: bc2a78ac-a06e-40fd-b2b7-1b1e062f3f9e syncScheduled: 1644759037120 chassis-serial-number: None cpuLoad: 1.46 state_description: All daemons up vsmart-list-version: '9223372036854775807' vbond: 10.103.135.135 ompPeersUp: 2 syncQueued: 1644759037119 isDeviceGeoData: false device-type: vedge state: green firmwareVersion: '---' organization-name: vIPtela Inc Regression-Apple Inc longitude: '-122.777023' syncCompleted: 1644759039647 domain-id: '1' downloadedServices: [] availableServices: [] expectedControlConnections: 2 memUsageDisplay: '24.1' model_sku: None sp-organization-name: vIPtela Inc Regression version: 20.6.2-440 firmwareAvailablePackages: [] layoutLevel: 4 bootloader_version: Not applicable fips_mode: enabled name: 169.254.10.10 controlConnectionsUp: 3 controlConnectionsToVsmarts: '2' number-vbond-peers: '1' defaultVersion: 20.6.2-440 status: normal ompPeers: '2' memState: normal chassis-number: bc2a78ac-a06e-40fd-b2b7-1b1e062f3f9e board_type: Sim device-os: next local-system-ip: 172.16.254.2 timezone: UTC latitude: '37.666684' system-ip: 169.254.10.10 site-id: '3' certificate-not-valid-after: Jan 29 00:19:35 2023 GMT downloadedImages: [] platform: x86_64 hardwareState: normal board-serial: '12345708' '@rid': 2493 personality: vedge memUsage: 24.1 lastDataSyncTime: 1644801887955 certificate-status: Installed reachability: reachable controlConnections: '3' linux_cpu_count: '1' controlConnectionsDown: 0 availableVersions: [] number-vsmart-peers: 2 connectedVManages: - 169.254.10.3 testbed_mode: true syncState: Completed firmwareAvailableVersions: [] host-name: vm3 bfdSessionsDown: 0 tcpd_cpu_count: '0' uptime: 15 days 13 hrs 52 min 15 sec token: Invalid cpuLoadDisplay: '1.46' certificate-validity: Valid cpuState: normal number-vsmart-control-connections: 2 vmanage-system-ip: 169.254.10.10 ompPeersDown: 0 bfdSessions: '5' tenantId: c2c6093d-a33c-400a-90e8-1f549fe7a12c vmanageConnectionState: connected build_number: '440' lastupdated: 1644759039485 device-category: vedge device-groups: - No groups hasGeoData: true uptime-date: 1643413080000 isMultiStepUpgradeSupported: false bfdSessionsUp: 5 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: System-read,System-write /device/system/statistics: get: tags: - Real-Time Monitoring - System description: Get device system stats list (Real Time) operationId: createDeviceSystemStatsList parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system stats: description: Device system stats value: data: - tx_gre_pkts: 132344 tx_arp_replies: 1700 rx_icmp_port_unreach: 303 rx_window_drops_tc6: 0 rx_window_drops_tc7: 0 tx_arp_reqs: 43535 rx_window_drops_tc4: 0 rx_window_drops_tc5: 0 pko_wred_drops: 0 rx_window_drops_tc2: 0 rx_window_drops_tc3: 0 rx_window_drops_tc0: 0 rx_window_drops_tc1: 0 bfd_rx_non_ip: 0 ip_fwd_mcast_invalid_iif: 0 route_to_host: 0 tx_pkts: 55508251 arp_add_fail: 51 tx_ipsec_policer_drops: 0 tx_fragment_drops: 0 ip_fwd_from_cpu_non_local: 0 ip_fwd_null_mcast_group: 0 buf_alloc_fails: 0 fragment_df_drops: 0 rx_drops: 0 tx_fragment_fail: 0 bfd_lkup_fail: 0 rx_icmp_network_unreach: 9 vdevice-name: 169.254.10.10 tx_icmp_fragment_required: 0 cflowd_pkts: 0 tx_fragment_alloc_fail: 0 rx_replay_integrity_drops_tc3: 0 rx_replay_integrity_drops_tc4: 0 rx_replay_integrity_drops_tc5: 0 rx_sa_ipsec_drops: 0 rx_replay_integrity_drops_tc6: 0 openssl_aes_encrypt: 0 rx_replay_integrity_drops_tc7: 0 to_cpu_policer_drops: 3173 rx_icmp_redirect: 0 tx_no_tunn_pre_ipsec_drops: 0 tx_icmp_src_quench: 0 rx_icmp_ttl_expired: 0 rx_replay_integrity_drops_tc0: 1 rx_replay_integrity_drops_tc1: 0 rx_arp_reqs: 1333 rx_replay_integrity_drops_tc2: 0 tx_icmp_ttl_expired: 0 ip_fwd_mirror_pkts: 0 rx_non_ip_drops: 1469202 rx_icmp_bad_ip_hdr: 0 tx_ip6_ipsec_drops: 0 nat_xlate_outbound_drops: 0 rx_err_pad_ipsec_drops: 0 rx_pre_ipsec_pkts: 0 lastupdated: 1644814365917 tx_icmp_policer_drops: 0 mirror_drops: 0 rx_ipsec_bad_inner: 0 rx_ip_errs: 0 ip_fwd_null_nhop: 132344 tx_bcast: 2353 bfd_rx_parse_err: 0 rx_bcast: 185 rx_icmp_echo_requests: 0 tx_if_not_preferred: 1197705 tx_icmp_dst_unreach_other: 0 rx_invalid_port: 0 split_horizon_drops: 0 rx_icmp_other_types: 5458 rx_arp_replies: 43098 tx_no_out_sa_pre_ipsec_drops: 0 invalid_back_ptr: 0 rx_pkts: 31444972 rx_invalid_qtags: 244 ip_fwd_to_cpu_nat_drops: 0 tx_gre_drops: 0 rx_icmp_src_quench: 0 rx_gre_policer_drops: 0 cbf_discards: 0 tx_gre_policer_drops: 0 rx_arp_non_local_drops: 161199 ip_fwd_unknown_nh_type: 0 tx_arp_req_fail: 0 tx_icmp_echo_requests: 486552 ip_fwd_to_egress: 22866794 tx_ipsec_encap: 16205725 rx_tunneled_pkts: 0 bfd_tx_record_changed: 374 rx_mcast_mirror_fwd_drops: 0 rx_unexpected_replay_drops_tc1: 0 rx_unexpected_replay_drops_tc2: 0 rx_unexpected_replay_drops_tc3: 0 rx_invalid_ipsec_pkt_size: 0 rx_unexpected_replay_drops_tc4: 0 ip_disabled_tx: 0 rx_unexpected_replay_drops_tc0: 0 rx_ipsec_policer_drops: 0 rx_unexpected_replay_drops_tc5: 0 rx_unexpected_replay_drops_tc6: 0 rx_unexpected_replay_drops_tc7: 0 rx_replay_drops_tc7: 0 rx_replay_drops_tc5: 0 ip_fwd_to_cpu_nat_xlates: 0 rx_replay_drops_tc6: 0 vdevice-dataKey: 169.254.10.10 rx_replay_drops_tc3: 0 rx_replay_drops_tc4: 0 rx_replay_drops_tc1: 0 rx_ipsec_decap: 16201636 rx_replay_drops_tc2: 0 rx_spi_ipsec_drops: 0 rx_replay_drops_tc0: 0 rx_host_mirror_drops: 0 rx_gre_drops: 0 ip_fwd_nat_on_tunnel: 0 rx_cp_non_local: 0 ip_fwd_to_cpu: 6893414 bfd_rx_record_invalid: 0 no_nat_nexthop: 0 tx_fragment_needed: 0 ip_fwd_mcast_life_exceeded_drops: 0 rx_pre_ipsec_decap: 0 ip_fwd: 46077192 rx_unexpected_replay_drops: 0 bfd_rec_down: 0 tunnel_pmtu_lowered: 0 filter_drops: 0 rx_icmp_protocol_unreach: 0 tx_queue_exceeded: 0 nat_xlate_inbound_fail: 0 tx_icmp_bad_ip_hdr: 0 nat_xlate_inbound: 0 rx_arp_rate_limit_drops: 0 bfd_rec_invalid: 1 rx_implicit_acl_drops: 869 ip_disabled_rx: 0 rx_mac_compare_ipsec_drops: 0 tx_ipsec_pkts: 16205725 rx_mcast_threshold_exceeded: 0 bfd_timer_add_fail: 0 openssl_aes_decrypt: 0 nat_xlate_outbound: 0 tx_ipsec_mcast_encap: 0 rx_gre_decap: 0 tx_errors: 0 bfd_tx_pkts: 16142569 service_label_fwd: 0 unknown_nh_type: 0 rx_mcast_policy_fwd_drops: 0 rx_pre_ipsec_drops: 0 tx_icmp_host_unreach: 0 vdevice-host-name: vm3 rx_icmp_host_unreach: 0 rx_icmp_dst_unreach_other: 0 tx_icmp_redirect: 0 rx_mcast_link_local: 17935 rx_host_local_pkt: 0 tx_fragments: 0 tx_icmp_port_unreach: 50 icmp_redirect: 0 rx_mcast: 18682 tx_mcast: 55760 tx_mcast_fragment_needed: 0 rx_replay_integrity_drops: 1 rx_mcast_filter_to_cpu: 0 ip_fwd_rx_gre: 0 tx_icmp_protocol_unreach: 0 port_disabled_rx: 9018 ttl_expired: 0 tx_gre_encap: 132344 bfd_rx_pkts: 16138479 ip_fwd_arp: 1187 tx_icmp_network_unreach: 0 ip_fwd_invalid_tun_oil: 0 ip_fwd_rx_ipsec: 16202760 tx_icmp_other_types: 654 rx_no_tun_if: 0 app_route_policy_discards: 0 tx_no_out_sa_ipsec_drops: 0 rx_bad_label: 0 tx_pre_ipsec_pkts: 16205725 rx_mcast_filter_to_cpu_and_fwd: 0 tx_pre_ipsec_policer_drops: 0 rx_next_hdr_ipsec_drops: 0 bfd_tx_fail: 0 rx_ip6_ipsec_drops: 0 tunnel_loop_drops: 0 tx_arp_rate_limit_drops: 0 bfd_alloc_fail: 0 tx_pre_ipsec_encap: 16205725 ip_v6_mcast_drops: 0 port_disabled_tx: 193 ecmp_discards: 0 tx_icmp_echo_replies: 0 rx_icmp_fragment_required: 0 ip_fwd_from_cpu_nat_xlates: 0 rx_icmp_echo_replies: 486048 tx_no_tunn_ipsec_drops: 0 tx_no_arp_drop: 0 tx_vsmart_drop: 0 rx_policer_drops: 0 ip_fwd_invalid_oil: 0 rx_replay_drops: 0 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read /device/system/status: get: tags: - Real-Time Monitoring - System description: Get device system status list (Real Time) operationId: createDeviceSystemStatusList parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system status: description: Device system status value: data: - mem_used: '954024' procs: '244' disk_avail: 7015M disk_mount: / board_type: Sim vdevice-name: 169.254.10.10 total_cpu_count: '2' mem_cached: '740972' reboot_type: Not Applicable disk_fs: /dev/root fp_cpu_count: '1' chassis-serial-number: None min1_avg: '1.06' state_description: All daemons up personality: vedge disk_used: 174M disk_use: '2' disk_status: enabled state: green config_date/date-time-string: Mon Feb 14 04:47:05 UTC 2022 linux_cpu_count: '1' cpu_user: '5.53' testbed_mode: '1' min15_avg: '1.08' disk_size: 7615M cpu_idle: '91.96' mem_buffers: '82140' model_sku: None cpu_system: '2.51' version: 20.6.2-440 min5_avg: '1.10' tcpd_cpu_count: '0' vdevice-host-name: vm3 mem_total: '3906816' uptime: 16 days 05 hrs 08 min 45 sec vdevice-dataKey: 169.254.10.10 mem_free: '2129680' bootloader_version: Not applicable fips_mode: enabled build_number: '440' lastupdated: 1644814027189 loghost_status: disabled uptime-date: 1643413080000 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read,dca /device/system/synced/status: get: tags: - Real-Time Monitoring - System description: Get device system stats list synchronously operationId: createSyncedDeviceSystemStatusList parameters: - name: deviceId in: query description: deviceId - Device IP required: true schema: pattern: ^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?).){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$ type: string example: 169.254.10.10 responses: '200': description: Success content: application/json: schema: type: object examples: Device system stats: description: Device system stats value: data: - vdevice-name: 172.16.255.11 board_type: Sim total_cpu_count: '2' reboot_type: NotApplicable fp_cpu_count: '1' chassis-serial-number: None state_description: Alldaemonsup '@rid': 1175 personality: vedge disk_status: enabled state: green linux_cpu_count: '1' testbed_mode: '1' createTimeStamp: 1647316043522 model_sku: None version: 20.9.999-1787 tcpd_cpu_count: '0' vdevice-host-name: vm1 vdevice-dataKey: 172.16.255.11 vmanage-system-ip: 172.16.255.11 bootloader_version: Notapplicable fips_mode: enabled lastupdated: 1647316042867 build_number: '1787' loghost_status: disabled uptime-date: 1647312840000 '400': description: Bad Request '403': description: Forbidden '500': description: Internal Server Error x-roles-required: Device Monitoring-read