Interfaces

listInterfaces

Lists all the interfaces monitored in OpManager

HTTP Method

GET

API URL

https://localhost:8060/api/json/device/listInterfaces?apiKey=***************&rows=100&page=1

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI key to access your OpManager server.String-Yes
rowsNumber of rows to fetch in the current batch.IntegerExample: rows=100 or page=1&rows=100. (It is recommended to fetch a maximum of 1000 rows per request.)Yes
pageUsed along with the rows parameter to fetch data in batches.IntegerExample: page=1&rows=100No

Sample Response

HTTP Code: 200

{
    "total": "2",
    "records": "2",
    "page": "1",
    "rows": [
        {
            "interfaceDisplayName": "HP ProCurve Switch software loopback interface-lo4",
            "statusStr": "Clear",
            "stateNum": 1,
            "displayName": "OPM-CoreRouter",
            "ipAddress": "",
            "outSpeed": "0 bps",
            "inSpeed": "0 bps",
            "type": "Software Loopback",
            "deviceName": "xxx.xxx.xx.x",
            "interfaceStatus": 5,
            "outTraffic": "67.398 M (0.0%)",
            "statusNum": 5,
            "inTraffic": "110.774 M (0.0%)",
            "adminStatus": "Up",
            "operStatus": "Up",
            "id": "26732",
            "interfaceName": "IF-xxx.xxx.xx.x-26732"
        },
        {
            "interfaceDisplayName": "sit0-sit0",
            "statusStr": "Trouble",
            "stateNum": 1,
            "displayName": "OPM-SWITCH",
            "ipAddress": "",
            "outSpeed": "0 bps",
            "inSpeed": "0 bps",
            "type": "Tunnel",
            "deviceName": "xxx.xxx.xx.x",
            "interfaceStatus": 2,
            "outTraffic": "69.481 M (0.0%)",
            "statusNum": 2,
            "inTraffic": "90.512 M (0.0%)",
            "adminStatus": "Up",
            "operStatus": "Up",
            "id": "4006",
            "interfaceName": "IF-xxx.xxx.xx.x-4006"
        }
    ]
}
Rate limit: 500 requests per minute. Exceeding this limit will block requests for 1 minute

getInterfaceSummary

Retrieves comprehensive summary information (such as ifAlias, Rx/Tx traffic, etc.) for a specific network interface.

HTTP Method

GET

API URL

https://localhost:8060/api/json/device/getInterfaceSummary?apiKey=***************&interfaceName=IF-xxx.xxx.xx.x-4429

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI key to access your OpManager server.String-Yes
interfaceNameInternal name of the interface.

This value can be obtained from the 'interfaceName' field in the listInterfaces API response.
String-Yes

Sample Response

HTTP Code: 200

{
  "recBandwidth": "1000",
  "instance": "2",
  "Util": "7",
  "avgOutPackets": "6.932 M",
  "outTraffic": "68.544 M",
  "moID": "5565",
  "isIPAvailable": false,
  "intfDisplayName": "GigabitEthernet0-2-TRUNK03",
  "txUtil": "6.85",
  "rstime": "1 Gbps",
  "statusPollEnabled": "true",
  "ifAdminStatus": "1",
  "isAgentMonitoring": false,
  "ifSpeedIn": "1000",
  "rxUtil": "6.03",
  "ifName": "GigabitEthernet0-2",
  "stringStatus": "Up",
  "Discards": "2",
  "Errors": "0",
  "pollInterval": "900",
  "operState": "Up",
  "intfmanaged": "true",
  "name": "xxx.xxx.xx.x",
  "typeId": "6",
  "desc": "TRUNK03",
  "status": "5",
  "trafficCounter": "64 bit",
  "displayName": "PaloAlto Firewall Device",
  "availability": {
    "Down": 0,
    "Dependent Unavailable": 0,
    "Not Monitored": 0,
    "On Hold": 0,
    "Parent Down": 0,
    "On Maintenance": 0,
    "Up": 100
  },
  "inSpeedDisplayValue": "1 Gbps",
  "typeIdDescr": "Ethernet (6)",
  "isSubInterface": "false",
  "managed": "true",
  "ifPhysAddr": "24 0b 0a 01 81 e2",
  "adminState": "Up",
  "transBandwidth": "1000",
  "outSpeedDisplayValue": "1 Gbps",
  "availabilityTimeLine": [
    "UP,1782316838641,1782335198641,Up"
  ],
  "rxPackets": "1.586 K",
  "txPackets": "1.235 K",
  "pollingStatus": "0",
  "ifSpeedOut": "1000",
  "inTraffic": "60.32 M",
  "intfMoName": "IF-xxx.xxx.xx.x-5565",
  "ifOperStatus": "1",
  "category": "Firewall",
  "avgInPackets": "4.753 M"
}
Rate limit: 50 requests per minute. Exceeding this limit will block requests for 1 minute

getIntfAtAGlanceReportDetails

Provides a consolidated availability and performance monitoring health report data for the given interface.

HTTP Method

GET

API URL

https://localhost:8060/api/json/v2/device/getIntfAtAGlanceReportDetails?apiKey=***************&InterfaceName=IF-xxx.xxx.xx.4-3820&period=Today

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI key to access your OpManager server.String-Yes
InterfaceNameInternal name of the interface.

This value can be obtained from the 'interfaceName' field in the listInterfaces API response.
String-Yes
periodTime period for which the report is to be generated. For 'custom' time period, supply 'startDate' and 'endDate'.StringAllowed patterns: onehour|twohours|fourhours|sixhours|eighthours|twelvehours|twfourhours|Today|Yesterday|thisweek|lastweek|Last_7_Days|Last_30_Days|Last_60_Days|Last_90_Days|thismonth|Last_Month|Last_3_Months|Last_6_Months|Last_Quarter|This_Quarter|custom.
The default value is 'Today'.
Yes
startDateFrom Date. This parameter is applicable only if 'custom' time is opted in period param valueStringAllowed values: day/month/year hours:minutes
Example: 13/08/2026 03:00
No
endDateTo Date. This param is applicable only if 'custom' time is opted in period param valueStringAllowed values: day/month/year hours:minutes
Example:13/08/2026 04:00
No

Sample Response

HTTP Code: 200

{
    "intfDisplayName": "WAN Miniport -IPv6--Npcap Packet Driver -NPCAP--0000-Local Area Connection* 8-Npcap Packet Driver -NPCAP--0000",
    "InterfaceCategory": "LAN",
    "Details": {
        "Parent Name": "opm-core-switch1",
        "IfDescr": "WAN Miniport (IPv6)-Npcap Packet Driver (NPCAP)-0000",
        "IfAlias": "Local Area Connection* 8-Npcap Packet Driver (NPCAP)-0000",
        "IfIndex": "26",
        "Receive Bandwidth": "0 bps",
        "IfName": "ethernet_8",
        "Transmit Bandwidth": "0 bps",
        "Circuit ID": "-"
    },
    "repType": 7,
    "graphData": {
        "Availability": [
            [
                "Up",
                "90"
            ],
            [
                "On Maintenance",
                "10"
            ],
            [
                "Dependent Unavailable",
                "0"
            ],
            [
                "On Hold",
                "0"
            ],
            [
                "Down",
                "0"
            ],
            [
                "Not Monitored",
                "0"
            ],
            [
                "Parent Down",
                "0"
            ]
        ],
        "outUtilization": [
            {
                "seriesname": "outUtilization",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Percentage"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "Discards": [
            {
                "seriesname": "inDiscards",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Discards/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            },
            {
                "seriesname": "outDiscards",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Discards/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "outTraffic": [
            {
                "seriesname": "outTraffic",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "bps"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "Errors": [
            {
                "seriesname": "inErrors",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Errors/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            },
            {
                "seriesname": "outErrors",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Errors/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "Unicast": [
            {
                "seriesname": "broadcast",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "%"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            },
            {
                "seriesname": "unicast",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "%"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "outBytes": [
            {
                "seriesname": "outBytes",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    ""
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "inTraffic": [
            {
                "seriesname": "inTraffic",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "bps"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "inBytes": [
            {
                "seriesname": "inBytes",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Bytes/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "inUtilization": [
            {
                "seriesname": "inUtilization",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Percentage"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "totalUtilization": [
            {
                "seriesname": "totalUtilization",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Percentage"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "inFrames": [
            {
                "seriesname": "inFrames",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Frames/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ],
        "outFrames": [
            {
                "seriesname": "outFrames",
                "data": [
                    [
                        1785263761113,
                        0,
                        "0 "
                    ],
                    [
                        1785264361283,
                        0,
                        "0 "
                    ],
                    [
                        1785264961074,
                        0,
                        "0 "
                    ]
                ],
                "xyTitles": [
                    "Time",
                    "Frames/sec"
                ],
                "yaxiscolumnorder": [
                    0
                ],
                "suffix": ""
            }
        ]
    }
}
Rate limit: 100 requests per minute. Exceeding this limit will block requests for 1 minute

getIntfBWOutageReportDetails

Provides data for consolidated Bandwidth report (Rx/Tx Traffic) for the given interface.

HTTP Method

GET

API URL

https://localhost:8060/api/json/v2/device/getIntfBWOutageReportDetails?apiKey=***************&interfaceName=IF-xxx.xxx.xx.x-3836&period=Today

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI Key to access your OpManager server.String-Yes
interfaceNameInternal name of the interface.

This value can be obtained from the 'interfaceName' field in the listInterfaces API response.
String-Yes
periodTime period for which the report is to be generated. For 'custom' time period, supply 'startDate' and 'endDate'.StringAllowed patterns: onehour|twohours|fourhours|sixhours|eighthours|twelvehours|twfourhours|Today|Yesterday|thisweek|lastweek|Last_7_Days|Last_30_Days|Last_60_Days|Last_90_Days|thismonth|Last_Month|Last_3_Months|Last_6_Months|Last_Quarter|This_Quarter|custom.
The default value is 'Today'.
Yes
startDateFrom Date. This parameter is applicable only if 'custom' time is opted in period param valueStringAllowed values: day/month/year hours:minutes
Example: 13/08/2026 03:00
No
endDateTo Date. This param is applicable only if 'custom' time is opted in period param valueStringAllowed values: day/month/year hours:minutes
Example:13/08/2026 04:00
No

Sample Response

HTTP Code: 200

{ "InSpeed": "0 bps", "IfDesc": "Switch loopback interface", "repType": 9, "consolidatedValues": [ { "minCollectionTime": "1760677410060", "currVal": "1.309 K ( 0.0 % )", "seriesName": "InTraffic", "exactMaxVal": 14.45119, "maxCollectionTime": "1760679211506", "95thpercVal": "1.0659", "legendType": "intfGraph", "95thpercentileValue": "14.451 K ( 0.0 % )", "exactMinVal": 0.75889, "maxVal": "14.451 K ( 0.0 % )", "minVal": "758.89 ( 0.0 % )", "95thpercRawVal": "1065.9", "avgVal": "3.742 K ( 0.0 % )", "95thperc": "1.065 K ( 0.0 % )"}, { "minCollectionTime": "1760677410060", "currVal": "1.202 K ( 0.0 % )", "seriesName": "OutTraffic", "exactMaxVal": 13.241100000000001, "maxCollectionTime": "1760679211506", "95thpercVal": "0.9796275000000001", "legendType": "intfGraph", "95thpercentileValue": "13.241 K ( 0.0 % )", "exactMinVal": 0.69837, "maxVal": "13.241 K ( 0.0 % )", "minVal": "698.37 ( 0.0 % )", "95thpercRawVal": "979.6275", "avgVal": "3.431 K ( 0.0 % )", "95thperc": "979.627 ( 0.0 % )"}, { "95thpercentileValue": "27.692 K ( 0.0 % )", "minCollectionTime": "1760677410060", "maxVal": "27.692 K ( 0.0 % )", "currVal": "2.512 K ( 0.0 % )", "minVal": "1.457 K ( 0.0 % )", "seriesName": "Total", "95thpercRawVal": "2045.5324999999993", "avgVal": "7.174 K ( 0.0 % )", "95thperc": "2.045 K ( 0.0 % )", "maxCollectionTime": "1760679211506", "95thpercVal": "2.0455324999999993", "legendType": "intfGraph"} ], "seriesNames": [ "InTraffic", "OutTraffic", "Total", "InTraffic-95th", "OutTraffic-95th", "Total-95th" ], "bwChartData": [ { "seriesname": "InTraffic", "isRaw": true, "data": [ [ 1760677410060, 0.75889, "758.89 " ], [ 1760678311494, 1.30847, "1.308 K" ], [ 1760679211506, 14.45119, "14.451 K" ], [ 1760680111518, 0.88658, "886.58 " ], [ 1760681011535, 1.30966, "1.309 K" ] ], "xyTitles": [ "Time", "Bits per Second" ]}, { "seriesname": "OutTraffic", "isRaw": true, "data": [ [ 1760677410060, 0.69837, "698.37 " ], [ 1760678311494, 1.20186, "1.201 K" ], [ 1760679211506, 13.241100000000001, "13.241 K" ], [ 1760680111518, 0.8154, "815.4 " ], [ 1760681011535, 1.2028800000000002, "1.202 K" ] ], "xyTitles": [ "Time", "Bits per Second" ]}, { "seriesname": "Total", "isRaw": true, "data": [ [ 1760677410060, 1.45727, "1.457 K" ], [ 1760678311494, 2.5103299999999997, "2.51 K" ], [ 1760679211506, 27.69229, "27.692 K" ], [ 1760680111518, 1.7019900000000001, "1.701 K" ], [ 1760681011535, 2.51254, "2.512 K" ] ], "xyTitles": [ "Time", "Bits per Second" ]}, { "seriesname": "InTraffic-95th", "data": [ [ 1760677410060, 1.0659, "1.065 K" ], [ 1760681011535, 1.0659, "1.065 K" ] ], "xyTitles": [ "Time", "Bits per Second" ]}, { "seriesname": "OutTraffic-95th", "data": [ [ 1760677410060, 0.9796275000000001, "979.627 " ], [ 1760681011535, 0.9796275000000001, "979.627 " ] ], "xyTitles": [ "Time", "Bits per Second" ]}, { "seriesname": "Total-95th", "data": [ [ 1760677410060, 2.0455324999999993, "2.045 K" ], [ 1760681011535, 2.0455324999999993, "2.045 K" ] ], "xyTitles": [ "Time", "Bits per Second" ]} ], "InterfaceDisplayName": "Switch loopback interface-lo0", "IfAlias": "lo0", "suffix": "K", "availData":{ "Down": 0, "Dependent Unavailable": 0, "Not Monitored": 0, "On Hold": 0, "Parent Down": 0, "On Maintenance": 0, "Up": 100}, "deviceName": "IF-xxx.xxx.xx.x-13767", "interfaceDetails":{ "Parent Name": "xxx.xxx.xx.x", "IfDescr": "Switch loopback interface", "IfIndex": "4875", "IfAlias": "lo0", "IfName": "lo0", "Circuit ID": "-"}, "OutSpeed": "0 bps", "name": "xxx.xxx.xx.x", "CircuitID": "-", "IfIndex": "4875", "InterfaceName": "IF-xxx.xxx.xx.x-13767", "IfName": "lo0"}
Rate limit: 100 requests per minute. Exceeding this limit will block requests for 1 minute

getInterfaces

Provides the list of available interfaces in a device.

HTTP Method

GET

API URL

https://localhost:8060/api/json/device/getInterfaces?apiKey=***************&name=xxx.xxx.xx.x

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI Key to access your OpManager server.String-Yes
nameInternal name of the device used to uniquely identify it.

This value can be retrieved from the 'deviceName' field in the listDevices API response.
String-Yes

Sample Response

HTTP Code: 200

{
    "isSNMP": true,
    "downCount": "4",
    "interfaces": [
        {
            "ifIndex": "1",
            "statusStr": "Unknown",
            "ifType": "Ethernet",
            "imagePath": "/apiclient/ember/images/intfTypes/ifType6.gif",
            "displayName": "Ethernet0-ifAlias",
            "RouterPortType": "Eth",
            "outSpeed": "10 M",
            "inSpeed": "10 M",
            "type": "Interface",
            "nfEnabled": "false",
            "outTraffic": "NA",
            "moid": "1808",
            "suppressedMessage": "",
            "bgColor": "808080",
            "isSubInterface": "true",
            "connected-device": "",
            "ifAdminStatus": "1",
            "ifIndexNum": 1,
            "inUtil": "NA",
            "isSuppressed": false,
            "trimmedDispName": "Ethernet0-ifAlias",
            "ipAddress": "xxx.xxx.xx.x",
            "pollingStatus": "15",
            "statusNum": "7",
            "inTraffic": "NA",
            "outUtil": "NA",
            "statusString": "Unknown",
            "name": "IF-xxx.xxx.xx.x-1808",
            "ifOperStatus": "1",
            "errors": "NA",
            "status": "7"
        },
        {
            "ifIndex": "1",
            "statusStr": "Trouble",
            "ifType": "Ethernet",
            "imagePath": "/apiclient/ember/images/intfTypes/ifType6.gif",
            "displayName": "Ethernet0-ifAlias",
            "RouterPortType": "Eth",
            "outSpeed": "10 M",
            "inSpeed": "10 M",
            "type": "Interface",
            "nfEnabled": "false",
            "outTraffic": "103.081 Mbps",
            "moid": "1807",
            "suppressedMessage": "",
            "bgColor": "ff8000",
            "isSubInterface": "false",
            "connected-device": "",
            "ifAdminStatus": "1",
            "ifIndexNum": 1,
            "inUtil": "100.0",
            "isSuppressed": false,
            "trimmedDispName": "Ethernet0-ifAlias",
            "ipAddress": "xxx.xxx.xx.x",
            "pollingStatus": "0",
            "statusNum": "2",
            "inTraffic": "75.785 Mbps",
            "outUtil": "100.0",
            "statusString": "Trouble",
            "name": "IF-xxx.xxx.xx.x-1807",
            "ifOperStatus": "1",
            "errors": "13011",
            "status": "2"
        },
        {
            "ifIndex": "2",
            "statusStr": "Trouble",
            "ifType": "Serial",
            "imagePath": "/apiclient/ember/images/intfTypes/ifType22.gif",
            "displayName": "Serial0-ifAlias",
            "RouterPortType": "Serial",
            "outSpeed": "2 M",
            "inSpeed": "2 M",
            "type": "Interface",
            "nfEnabled": "false",
            "outTraffic": "NA",
            "moid": "1809",
            "suppressedMessage": "",
            "bgColor": "ff8000",
            "isSubInterface": "false",
            "connected-device": "",
            "ifAdminStatus": "1",
            "ifIndexNum": 2,
            "inUtil": "NA",
            "isSuppressed": false,
            "trimmedDispName": "Serial0-ifAlias",
            "ipAddress": "",
            "pollingStatus": "0",
            "statusNum": "2",
            "inTraffic": "NA",
            "outUtil": "NA",
            "statusString": "Trouble",
            "name": "IF-xxx.xxx.xx.x-1809",
            "ifOperStatus": "2",
            "errors": "NA",
            "status": "2"
        },
        {
            "ifIndex": "3",
            "statusStr": "Trouble",
            "ifType": "Serial",
            "imagePath": "/apiclient/ember/images/intfTypes/ifType22.gif",
            "displayName": "Serial1-ifAlias",
            "RouterPortType": "Serial",
            "outSpeed": "1 G",
            "inSpeed": "1 G",
            "type": "Interface",
            "nfEnabled": "false",
            "outTraffic": "NA",
            "moid": "1810",
            "suppressedMessage": "",
            "bgColor": "ff8000",
            "isSubInterface": "false",
            "connected-device": "",
            "ifAdminStatus": "1",
            "ifIndexNum": 3,
            "inUtil": "NA",
            "isSuppressed": false,
            "trimmedDispName": "Serial1-ifAlias",
            "ipAddress": "",
            "pollingStatus": "0",
            "statusNum": "2",
            "inTraffic": "NA",
            "outUtil": "NA",
            "statusString": "Trouble",
            "name": "IF-xxx.xxx.xx.x-1810",
            "ifOperStatus": "2",
            "errors": "NA",
            "status": "2"
        }
    ],
    "showPollingStatusColumn": true,
    "interfaceCount": "4"
}
Rate limit: 20 requests per minute. Exceeding this limit will block requests for 1 minute

getInterfaceNotes

Retrieves custom field values of an interface along with field metadata including data types and field properties.

HTTP Method

GET

API URL

https://opmserver:8060/api/json/device/getInterfaceNotes?apiKey=************&interfaceName=IF-xxx.xxx.xx.x-4505

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI key to access your OpManager server.String-Yes
interfaceNameInternal name of the interface.

This value can be obtained from the 'interfaceName' field in the listInterfaces API response.
String-Yes

Sample Response

HTTP Code: 200

[
  {
    "FIELDVALUE": "WAN LeaseLine Link1",
    "CUSTOMFIELDID": "1",
    "DATATYPE": "Text",
    "DESCRIPTION": "Purpose of the network interface",
    "FIELDNAME": "Interface Purpose",
    "ALIASNAME": "UDF1",
    "FIELDLENGTH": 250
  },
  {
    "FIELDVALUE": "CIR-5678",
    "CUSTOMFIELDID": "2",
    "DATATYPE": "Text",
    "DESCRIPTION": "Circuit identifier",
    "FIELDNAME": "Circuit ID",
    "ALIASNAME": "UDF2",
    "FIELDLENGTH": 100
  }
]
Rate limit: 50 requests per minute. Exceeding this limit will block requests for 1 minute

getInterfaceGraphs

Retrieves the collected data such as traffic, errors & discards, etc., for the given interface.

HTTP Method

GET

API URL

https://localhost:8060/api/json/device/getInterfaceGraphs?apiKey=***************&interfaceName=IF-xxx.xxx.xx.xxx-329&graphName=traffic

Parameters

Param NameDescriptionData TypeAdditional InformationIs Mandatory
apiKeyAPI Key to access your OpManager server.String-Yes
interfaceNameInternal name of the interface.

This value can be obtained from the 'interfaceName' field in the listInterfaces API response.
String-Yes
graphNameName of the interface graphStringAllowed patterns: traffic, packets, errors, totalPackets, utilization, rxutilization, txutilization, errorRate, discardRate.Yes
periodTime period for which the interface graph is to be generated.StringAllowed patterns: onehour|twohours|fourhours|sixhours|eighthours|twelvehours|twfourhours|Today|Yesterday|thisweek|lastweek|Last_7_Days|Last_30_Days|Last_60_Days|Last_90_Days|thismonth|Last_Month|Last_3_Months|Last_6_Months|Last_Quarter|This_Quarter|custom.
The default value is 'Today'.
No
startDateFrom Date. This parameter is applicable only if 'custom' time is opted in period param valueStringAllowed patterns: day/month/year hours:minutes
Allowed characters: day: 01–31, month: 01–12, year: any 4 digits, hours: 00–23, minutes: 00–59, slash(/), space( ), colon(:)
No
endDateTo Date. This parameter is applicable only if 'custom' time is opted in period param valueStringAllowed patterns: day/month/year hours:minutes
Allowed characters: day: 01–31, month: 01–12, year: any 4 digits, hours: 00–23, minutes: 00–59, slash(/), space( ), colon(:)
No
graphFilterTypeSpecifies the aggregation type for the graph data (min, max, avg)StringAllowed patterns: min, max, avg.No

Sample Response

HTTP Code: 200

{
    "interfaceDetails": {
        "Parent Name": "xxx.xxx.xx.x",
        "IfDescr": "B4",
        "IfIndex": "28",
        "IfAlias": "-",
        "IfName": "B4",
        "Circuit ID": "-"
    },
    "displayName": "Traffic",
    "consolidatedValues": {
        "Rx Traffic": {
            "minCollectionTime": "1786988763000",
            "currVal": "118.6 M ( 11.86 % )",
            "seriesName": "Rx Traffic",
            "exactMaxVal": 118.600415,
            "maxCollectionTime": "1787035563000",
            "95thpercVal": "84.23557846428572",
            "95thpercentileValue": "115.856 M ( 11.59 % )",
            "exactMinVal": 58.58383,
            "maxVal": "118.6 M ( 11.86 % )",
            "minVal": "58.583 M ( 5.86 % )",
            "95thpercRawVal": "8.423557846428572E7",
            "avgVal": "86.435 M ( 8.64 % )",
            "95thperc": "84.235 M ( 8.42 % )"
        },
        "Tx Traffic": {
            "minCollectionTime": "1787017563000",
            "currVal": "72.276 M ( 7.23 % )",
            "seriesName": "Tx Traffic",
            "exactMaxVal": 112.458731,
            "maxCollectionTime": "1786988763000",
            "95thpercVal": "81.58324892857144",
            "95thpercentileValue": "111.543 M ( 11.15 % )",
            "exactMinVal": 53.419168,
            "maxVal": "112.458 M ( 11.25 % )",
            "minVal": "53.419 M ( 5.34 % )",
            "95thpercRawVal": "8.158324892857143E7",
            "avgVal": "83.611 M ( 8.36 % )",
            "95thperc": "81.583 M ( 8.16 % )"
        }
    },
    "seriesNames": [
        "Rx Traffic",
        "Tx Traffic"
    ],
    "xyTitles": [
        "Time",
        "Bits per Second"
    ],
    "showGraphFilters": false,
    "graphData": [
        {
            "seriesname": "Rx Traffic",
            "data": [
                [
                    1786983367000,
                    109.812851,
                    "109.812 M"
                ],
                [
                    1786985163000,
                    102.623929,
                    "102.623 M"
                ],
                [
                    1787035563000,
                    118.600415,
                    "118.6 M"
                ]
            ]
        },
        {
            "seriesname": "Tx Traffic",
            "data": [
                [
                    1786983367000,
                    87.492656,
                    "87.492 M"
                ],
                [
                    1786985163000,
                    61.382223,
                    "61.382 M"
                ],
                [
                    1787035563000,
                    72.276606,
                    "72.276 M"
                ]
            ]
        }
    ],
    "suffix": "M"
}
Rate limit:100 requests per minute. Exceeding this limit will block requests for 1 minute