Skip to main content

Get Device Info

Retrieves information about the appliance. Use the Device ID value from the _id property to reference the device in subsequent API calls.

Authorizations: Administrator, Operator, Observer

Requests

GET /api/devices
cookie: sessionID: [Session ID]

Parameters

N/A

Response

[
 { 
  "_id": "[Device ID]", 
  "type": "gateway", 
  "ip": "127.0.0.1", 
  "name": "Haivision Gateway", 
  "lastConnectedAt": [Date/time shown in Unix time], 
  "statusCode": "ok", 
  "status": "Online", 
  "statusDetails": "Connection has been established in the last 1 minutes.", 
  "serialNumber": null, 
  "firmware": "5.0.180611.1530", 
  "hasAdminError": false, 
  "pendingSync": false, 
  "lastConnection": "<1m" 
 } 
]
NameTypeDescription
_idstring

Device ID.

typestringDevice type.
ipstring

IP address of the device.

Note

The IP address is from the front end to the backend, so 127.0.0.1 is expected.

namestringName of device.
lastConnectedAtnumberLast time connected to the device in Unix time.
statusCodestringDevice status code: warn, error, ok, or unknown.
statusstringDevice status: Online, Device error, Offline, Never, or Communication error.
statusDetailsstringDevice status details.
serialNumberstringDevice serial number.
firmwarestringDevice firmware version.
hasAdminErrorBooleanIndicates if device has an error.
pendingSyncBooleanIndicates if there is a device pending a sync task.
lastConnectionstringLast time connected to the device in string format (e.g., "<1m").

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.