Retrieve the status of an organization's devices

You can show the status of your devices - whether they are online, in standby mode, or offline. This can indicate whether the devices are actively on the job or parked. Additionally, you can provide the option to view live video from any devices that appear online.

Device status changes:

• Devices that are in standby mode get woken up when the vehicle moves, and their status changes to online.

• If your device is connected to a constant power source, the device status changes from online to standby when the vehicle stops moving for up to 60 minutes. The amount of time until your device enters standby mode can be updated with the standby parameter in the PUT /devices/{imei}/device-config call. The default value is 10 minutes.

• If your device is connected to an ignition power source, the device status changes from online to offline when the vehicle is turned off.

To show the status of devices, use the following API call in your application and poll the call according to the polling best practices: GET /organizations/{orgId}/devices?limit={limit}&offset={offset}

We recommend retrieving information by organiztion while using pagination (the limit and offset) in the query parameters to increase performance.

The returned response:

[ data: {
    "imei": "357660101035475",
    "name": "357660101035475",
    "groupId": -1,
    "vehicleType": "Private",
    "cameras": [
      {
        "cameraId": 1,
        "name": "Front Camera"
      },
      {
        "cameraId": 2,
        "name": "Rear Camera"
      }
    ],
    "iccid": "899720201470164615",
    "status": "standby",
    "lat": 32.19537996,
    "lon": 34.8839661,
    "alt": 110.69775390625,
    "lastSeenOnline": "2021-12-30T07:49:10.683Z",
    "firmwareVersion": "3.10.13",
    "deviceModel": "AI-12"
  },
  "metadata": {
    "count": 56,
    "limit": 10,
    "offset": 10
  }
]