Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools →
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cisco-catalyst-sdwan-real-time-monitoring-omp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Monitoring and Troubleshooting Real-Time Monitoring - OMP 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 - OMP
paths:
/device/omp/cloudx:
get:
tags:
- Real-Time Monitoring - OMP
description: Get CloudExpress routes received list
operationId: createOMPCloudXRecv
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: array
items:
type: object
examples:
CloudExpress routes received list:
description: CloudExpress routes received list
value:
data:
- vdevice-name: 172.16.254.1
vdevice-host-name: vm2
vpn-id: '1'
originator: 172.16.255.14
app-id: '1'
app-name: salesforce
to-peer: 172.16.255.19
from-peer: 172.16.255.20
status: C,I,R
latency: '0'
loss: '0'
vdevice-dataKey: 172.16.254.1
lastupdated: 1658131633272
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/links:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP connection list
operationId: createOMPLinkList
parameters:
- name: state
in: query
description: Connection state
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
examples:
OMP connection list:
description: OMP connection list
value:
data:
- state: up
lastupdated: '1646804216515'
linkKey: 172.16.255.16-172.16.255.20
adeviceId: 172.16.255.16
bdeviceId: 172.16.255.20
asystem-ip: 172.16.255.16
bsystem-ip: 172.16.255.20
asite-id: '600'
bsite-id: '200'
ahost-name: vm6
bhost-name: vm10
apersonality: vedge
bpersonality: vsmart
- state: up
lastupdated: '1646804204258'
linkKey: 172.16.255.16-172.16.255.19
adeviceId: 172.16.255.16
bdeviceId: 172.16.255.19
asystem-ip: 172.16.255.16
bsystem-ip: 172.16.255.19
asite-id: '600'
bsite-id: '100'
ahost-name: vm6
bhost-name: vm9
apersonality: vedge
bpersonality: vsmart
- state: up
lastupdated: '1646804204257'
linkKey: 172.16.255.15-172.16.255.19
adeviceId: 172.16.255.15
bdeviceId: 172.16.255.19
asystem-ip: 172.16.255.15
bsystem-ip: 172.16.255.19
asite-id: '500'
bsite-id: '100'
ahost-name: vm5
bhost-name: vm9
apersonality: vedge
bpersonality: vsmart
- state: up
lastupdated: '1646804216515'
linkKey: 172.16.255.15-172.16.255.20
adeviceId: 172.16.255.15
bdeviceId: 172.16.255.20
asystem-ip: 172.16.255.15
bsystem-ip: 172.16.255.20
asite-id: '500'
bsite-id: '200'
ahost-name: vm5
bhost-name: vm10
apersonality: vedge
bpersonality: vsmart
- state: up
lastupdated: '1646804204257'
linkKey: 172.16.255.14-172.16.255.19
adeviceId: 172.16.255.14
bdeviceId: 172.16.255.19
asystem-ip: 172.16.255.14
bsystem-ip: 172.16.255.19
asite-id: '400'
bsite-id: '100'
ahost-name: vm4
bhost-name: vm9
apersonality: vedge
bpersonality: vsmart
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: Device Monitoring-read
/device/omp/mcastautodiscoveradvt:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP multicast autodiscover advertised list
operationId: createOMPMcastAutoDiscoverAdvt
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: array
items:
type: object
examples:
OMP multicast autodiscover advertised list:
description: OMP multicast autodiscover advertised list
value:
data:
- vdevice-dataKey: 169.254.10.10-ipv4-10
vdevice-name: 169.254.10.10
lastupdated: 1643180905996
source-originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
to-peer: 172.16.253.129
- vdevice-dataKey: 169.254.10.10-ipv4-10
vdevice-name: 169.254.10.10
lastupdated: 1643180905996
source-originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
to-peer: 172.16.255.130
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/mcastautodiscoverrecv:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP multicast autodiscover received list
operationId: createOMPMcastAutoDiscoverRecv
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: array
items:
type: object
examples:
OMP multicast autodiscover received list:
description: OMP multicast autodiscover received list
value:
data:
- vdevice-dataKey: 169.254.10.10-ipv4-10
vdevice-name: 169.254.10.10
from-peer: 172.16.253.129
lastupdated: 1643181632850
source-originator: 172.16.254.1
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
status: C I R
- vdevice-dataKey: 169.254.10.10-ipv4-10
vdevice-name: 169.254.10.10
from-peer: 172.16.255.130
lastupdated: 1643181632851
source-originator: 172.16.254.1
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
status: C I R
- vdevice-dataKey: 169.254.10.10-ipv4-10
vdevice-name: 169.254.10.10
from-peer: 0.0.0.0
lastupdated: 1643181632852
source-originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
status: C Red R
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/mcastroutesadvt:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP multicast routes advertised list
operationId: createOMPMcastRoutesAdvt
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: array
items:
type: object
examples:
OMP multicast routes advertised list:
description: OMP multicast routes advertised list
value:
data:
- vdevice-name: 172.16.254.1
vdevice-host-name: vm2
address-family: ipv4
vpn-id: '1'
source-originator: 172.16.255.14
destination: 172.16.255.16
group: 225.0.0.1
source: 0.0.0.0
rp: 10.20.25.18
to-peer: 172.16.255.20
vdevice-dataKey: 172.16.254.1-ipv4-10
lastupdated: 0
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/mcastroutesrecv:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP multicast routes received list
operationId: createOMPMcastRoutesRecv
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: array
items:
type: object
examples:
OMP multicast routes received list:
description: OMP multicast routes received list
value:
data:
- vdevice-name: 172.16.254.1
vdevice-host-name: vm2
address-family: ipv4
vpn-id: '1'
source-originator: 172.16.255.14
destination: 172.16.255.16
group: 225.0.0.1
source: 0.0.0.0
from-peer: 172.16.255.19
status: C,I,R
vdevice-dataKey: 172.16.254.1-ipv4-10
lastupdated: 1658131633272
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/peers:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP session list (Real Time)
operationId: createOMPSessionList
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: array
items:
type: object
examples:
OP session list:
description: OP session list
value:
data:
- domain-id: 1
vdevice-name: 169.254.10.10
refresh: supported
site-id: 129
type: vsmart
vdevice-host-name: vm3
up-time-date: 1643135160000
vdevice-dataKey: 169.254.10.10-172.16.253.129-vsmart
peer: 172.16.253.129
up-time: 0:12:57:30
legit: 'yes'
lastupdated: 1643181828115
state: up
- domain-id: 1
vdevice-name: 169.254.10.10
refresh: supported
site-id: 130
type: vsmart
vdevice-host-name: vm3
up-time-date: 1643135160000
vdevice-dataKey: 169.254.10.10-172.16.255.130-vsmart
peer: 172.16.255.130
up-time: 0:12:57:30
legit: 'yes'
lastupdated: 1643181828115
state: up
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/routes/advertised:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP advertised routes list (Real Time)
operationId: createAdvertisedRoutesList
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: array
items:
type: object
examples:
OMP advertised routes list:
description: OMP advertised routes list
value:
data:
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 100.100.3.0/24
ip: 172.16.254.2
label: '1069'
encap: ipsec
site-id: '3'
originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
path-id: '65'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643179668956
to-peer: 172.16.253.129
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 100.100.3.0/24
ip: 172.16.254.2
label: '1069'
encap: ipsec
site-id: '3'
originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
path-id: '65'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643179668956
to-peer: 172.16.255.130
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/routes/advertised/ompIpv6:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP advertised routes list (Real Time)
operationId: createAdvertisedRoutesListIpv6
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: array
items:
type: object
examples:
OMP advertised routes list:
description: OMP advertised routes list
value:
data:
- color: lte
vdevice-name: 172.16.255.16
prefix: 2001:a14:19::/64
ip: 172.16.255.16
advertise-id: '70'
label: '1003'
encap: ipsec
site-id: '600'
originator: 172.16.255.16
vpn-id: '1'
vdevice-host-name: vm6
tenant-id: '0'
path-id: '70'
protocol: connected
vdevice-dataKey: 172.16.255.16-1
metric: '0'
lastupdated: 1653905306196
to-peer: 172.16.255.19
- color: lte
vdevice-name: 172.16.255.16
prefix: 2001:a14:19::/64
ip: 172.16.255.16
advertise-id: '70'
label: '1003'
encap: ipsec
site-id: '600'
originator: 172.16.255.16
vpn-id: '1'
vdevice-host-name: vm6
tenant-id: '0'
path-id: '70'
protocol: connected
vdevice-dataKey: 172.16.255.16-1
metric: '0'
lastupdated: 1653905306196
to-peer: 172.16.255.20
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
/device/omp/routes/received:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP received routes list (Real Time)
operationId: createReceivedRoutesList
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: array
items:
type: object
examples:
OMP received routes list:
description: OMP received routes list
value:
data:
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 10.0.5.0/24
ip: 172.16.254.4
from-peer: 172.16.253.129
label: '1047'
encap: ipsec
site-id: '5'
originator: 172.16.254.4
vpn-id: '10'
vdevice-host-name: vm3
path-id: '42'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C I R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 10.0.5.0/24
ip: 172.16.254.4
from-peer: 172.16.255.130
label: '1047'
encap: ipsec
site-id: '5'
originator: 172.16.254.4
vpn-id: '10'
vdevice-host-name: vm3
path-id: '42'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 10.0.16.0/24
ip: 172.16.254.16
from-peer: 172.16.253.129
label: '1014'
encap: ipsec
site-id: '16'
originator: 172.16.254.16
vpn-id: '10'
vdevice-host-name: vm3
path-id: '38'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C I R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 10.0.16.0/24
ip: 172.16.254.16
from-peer: 172.16.255.130
label: '1014'
encap: ipsec
site-id: '16'
originator: 172.16.254.16
vpn-id: '10'
vdevice-host-name: vm3
path-id: '38'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 100.100.2.0/24
ip: 172.16.254.1
from-peer: 172.16.253.129
label: '1018'
encap: ipsec
site-id: '2'
originator: 172.16.254.1
vpn-id: '10'
vdevice-host-name: vm3
path-id: '29'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C I R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 100.100.2.0/24
ip: 172.16.254.1
from-peer: 172.16.255.130
label: '1018'
encap: ipsec
site-id: '2'
originator: 172.16.254.1
vpn-id: '10'
vdevice-host-name: vm3
path-id: '29'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041519
attribute-type: installed
status: C R
- overlay-id: '1'
color: default
vdevice-name: 169.254.10.10
prefix: 100.100.3.0/24
ip: 172.16.254.2
from-peer: 0.0.0.0
label: '1069'
encap: ipsec
site-id: '3'
originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
path-id: '65'
protocol: connected
vdevice-dataKey: 169.254.10.10-10
metric: '0'
lastupdated: 1643182041520
attribute-type: installed
status: C Red R
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/routes/received/ompIpv6:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP received routes list (Real Time)
operationId: createReceivedRoutesListIpv6
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: array
items:
type: object
examples:
OMP received routes list:
description: OMP received routes list
value:
data:
- path-id: '830'
vdevice-dataKey: 172.16.255.16-1
vdevice-name: 172.16.255.16
prefix: 2001:a14:18::/64
from-peer: 172.16.255.19
lastupdated: 1653904719952
label: '1003'
vpn-id: '1'
vdevice-host-name: vm6
tenant-id: '0'
status: C I R
- path-id: '861'
vdevice-dataKey: 172.16.255.16-1
vdevice-name: 172.16.255.16
prefix: 2001:a14:18::/64
from-peer: 172.16.255.20
lastupdated: 1653904719952
label: '1003'
vpn-id: '1'
vdevice-host-name: vm6
tenant-id: '0'
status: C R
- path-id: '70'
vdevice-dataKey: 172.16.255.16-1
vdevice-name: 172.16.255.16
prefix: 2001:a14:19::/64
from-peer: 0.0.0.0
lastupdated: 1653904719952
label: '1003'
vpn-id: '1'
vdevice-host-name: vm6
tenant-id: '0'
status: C Red R
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
/device/omp/services:
get:
tags:
- Real-Time Monitoring - OMP
description: Get OMP services list
operationId: createOMPServices
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: array
items:
type: object
examples:
OMP services list:
description: OMP services list
value:
data:
- path-id: '65'
vdevice-dataKey: 169.254.10.10-10-VPN-172.16.254.2
vdevice-name: 169.254.10.10
service: VPN
from-peer: 0.0.0.0
lastupdated: 1643250832867
originator: 172.16.254.2
label: '1077'
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
status: C Red R
- vdevice-dataKey: 169.254.10.10-10-VPN-172.16.254.2
vdevice-name: 169.254.10.10
service: VPN
lastupdated: 1643250832868
originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
to-peer: 172.16.253.129
- vdevice-dataKey: 169.254.10.10-10-VPN-172.16.254.2
vdevice-name: 169.254.10.10
service: VPN
lastupdated: 1643250832869
originator: 172.16.254.2
vpn-id: '10'
vdevice-host-name: vm3
address-family: ipv4
to-peer: 172.16.255.130
'400':
description: Bad Request
'403':
description: Forbidden
'500':
description: Internal Server Error
x-roles-required: System-read,System-write,Routing-read,Routing-write,Policy-read,Policy-write
/device/omp/status:
get:
tags:
- Real-Time Monitoring - OMP
description: Get device OMP status
operationId: getDeviceOMPStatus
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
examples:
Device OMP status:
description: Device OMP status
value:
data:
- type: omp
# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-catalyst-sdwan/refs/heads/main/openapi/cisco-catalyst-sdwan-real-time-monitoring-omp-api-openapi.yml