Get list of company devices
GET
/companies/{company_id}/devices/list
User Role Permissions
| Role | Permission |
|---|---|
| Partner | |
| Partner View | |
| Custom Partner | |
| Fleet Manager | |
| Group Manager | |
| User | |
| Custom User |
Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/companies/123/devices/list?include_data=&page_number=1&page_size=60'Response Response Example
200 - Success
{
"meta": {
"code": 200
},
"response": {
"devices": [
{
"activated_timestamp": "2022-02-17 19:27:08",
"active": true,
"adas_camera_height": 150.0,
"adas_camera_offset": 0.0,
"adas_units": "imperial",
"adas_vehicle_hood_len": 150.0,
"adas_vehicle_width": 170.0,
"asset_id": 480,
"camera_health": {
"crit": 0,
"unacknowledged": 370,
"unacknowledged_sd20": 0,
"warn": 1,
"warn_sd20": 0
},
"canbus": "0",
"channel_available": "1,2",
"channel_status": [
{
"channel": 1,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2022-03-04 16:27:51"
},
{
"channel": 2,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2022-03-04 16:27:51"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 1,
"data_limit": 1,
"data_usage": 0,
"data_usage_live_stream": 0,
"device_id": "3931779166",
"device_type": "dv6",
"disable_live_stream": false,
"driver_id": null,
"driver_name": null,
"firmware_status": "firmware out of date",
"firmware_version": {
"firmware": "v2.1.0",
"gps": null,
"mcu": "79",
"mcu_pending": null,
"pdc": null,
"pdc_pending": null,
"uboot": null,
"uboot_pending": null
},
"general_status": null,
"geotab": {
"serial_number": null,
"status_tag": null
},
"gps_online": false,
"group_name": "EngineeringDV6",
"incorrect_device_time": true,
"ignition": {
"state": false,
"ts": "2022-03-04 16:44:56"
},
"installed_id": 399,
"last_connected_ts": "2022-03-04 16:22:50",
"last_disconnected_ts": "2022-03-04 16:47:00",
"last_sleep_connected_ts": null,
"last_sleep_disconnected_ts": null,
"last_speed": 0.292900608,
"latest_hdderror": {
"count": 0,
"first_ts": null,
"last_ts": null
},
"live_stream": {
"duration_month": 0,
"live_stream_access": true
},
"migration": false,
"modem": {
"imei": "015974000001668",
"simcard_iccid": null
},
"modem_rssi": null,
"no_sd_card": false,
"online": false,
"pending_company_profile": "Manual",
"sd_format": {
"geotab_user_id": null,
"num_reformats": null,
"sdformat_last_ts": null,
"sdformat_status": null,
"user_id": null
},
"sd_status": {},
"sd_wear": null,
"serial_number": "015974000001668",
"sleep": 0,
"tag_plate": "Julian DV6",
"timezone": null,
"uploaded_company_profile": null,
"vehicle_icon": "sports_car_1",
"vehicle_icon_size": true,
"vehicle_name": "Julian DV6",
"vin_number": "JHLRD77874C026456"
},
{
"activated_timestamp": "2022-02-17 20:23:35",
"active": true,
"adas_camera_height": 155.0,
"adas_camera_offset": 154.94,
"adas_units": "metric",
"adas_vehicle_hood_len": 155.0,
"adas_vehicle_width": 154.94,
"asset_id": 482,
"camera_health": {
"crit": 0,
"unacknowledged": 53,
"unacknowledged_sd20": 0,
"warn": 0,
"warn_sd20": 0
},
"canbus": "2",
"channel_available": "1,2",
"channel_status": [
{
"channel": 1,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2024-08-02 11:51:40"
},
{
"channel": 2,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/3983342988/failure_channels/2_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=dxymk%2FKM5Q4ElHaoUMYXzPC7qhA%3D&Expires=1762457367",
"fail_status": "black",
"fail_ts": "2024-06-19 17:54:16",
"misalignment": true,
"success_ts": "2024-08-02 11:51:40"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 1,
"data_limit": 1,
"data_usage": 0,
"data_usage_live_stream": 0,
"device_id": "3983342988",
"device_type": "dv6",
"disable_live_stream": false,
"driver_id": null,
"driver_name": null,
"firmware_status": "firmware update pending to dv6_v089.mcu",
"firmware_version": {
"firmware": "v2.6.0",
"gps": null,
"mcu": "88",
"mcu_pending": "dv6_v089.mcu",
"pdc": null,
"pdc_pending": null,
"uboot": null,
"uboot_pending": null
},
"general_status": "offline",
"geotab": {
"serial_number": null,
"status_tag": null
},
"gps_online": false,
"group_name": "NotUsed",
"incorrect_device_time": false,
"ignition": {
"state": true,
"ts": "2024-08-02 11:16:44"
},
"installed_id": 401,
"last_connected_ts": "2024-08-02 11:16:40",
"last_disconnected_ts": "2024-08-02 11:56:39",
"last_sleep_connected_ts": "2024-07-20 20:06:44",
"last_sleep_disconnected_ts": "2024-07-21 02:11:00",
"last_speed": null,
"latest_hdderror": {
"count": 1,
"first_ts": "2023-05-14 23:21:35",
"last_ts": "2023-05-14 23:21:35"
},
"live_stream": {
"duration_month": 0,
"live_stream_access": true
},
"migration": false,
"modem": {
"imei": "15974000000488",
"simcard_iccid": "89148000006859510313"
},
"modem_rssi": "-65",
"no_sd_card": false,
"online": false,
"pending_company_profile": "ADAS Test 1",
"sd_format": {
"geotab_user_id": null,
"num_reformats": null,
"sdformat_last_ts": null,
"sdformat_status": "sent",
"user_id": 4295
},
"sd_status": {},
"sd_wear": null,
"serial_number": "015974000000488",
"sleep": 0,
"tag_plate": "Amy car",
"timezone": "US/Eastern",
"uploaded_company_profile": "Manual",
"vehicle_icon": "ambulance",
"vehicle_icon_size": false,
"vehicle_name": "AmyDV6bg",
"vin_number": "JHLRD77874C026456"
},
{
"activated_timestamp": "2025-10-01 15:01:32",
"active": true,
"adas_camera_height": 150.0,
"adas_camera_offset": 0.0,
"adas_units": "imperial",
"adas_vehicle_hood_len": 0.0,
"adas_vehicle_width": 170.0,
"asset_id": null,
"camera_health": {
"crit": 0,
"unacknowledged": 0,
"unacknowledged_sd20": 0,
"warn": 0,
"warn_sd20": 0
},
"canbus": "0",
"channel_available": "1,2",
"channel_status": [
{
"channel": 1,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/3991896666/failure_channels/1_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=Zv%2FcvWND1oQSbXAsQa%2FFgSzst0s%3D&Expires=1762457367",
"fail_status": "black",
"fail_ts": "2025-10-03 03:32:38",
"success_ts": "2025-10-03 14:32:38"
},
{
"channel": 2,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2025-10-03 14:32:38"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 43484,
"data_limit": 1,
"data_usage": 8487375,
"data_usage_live_stream": 0,
"device_id": "3991896666",
"device_type": "dv6",
"disable_live_stream": false,
"driver_id": null,
"driver_name": null,
"firmware_status": "firmware out of date",
"firmware_version": {
"firmware": "v2.8.0",
"gps": null,
"mcu": "89",
"mcu_pending": null,
"pdc": null,
"pdc_pending": null,
"uboot": null,
"uboot_pending": null
},
"general_status": "driving",
"geotab": {
"serial_number": null,
"status_tag": null
},
"gps_online": false,
"group_name": "Installed Devices",
"incorrect_device_time": false,
"ignition": null,
"installed_id": null,
"last_connected_ts": "2025-10-05 17:38:04",
"last_disconnected_ts": "2025-10-05 17:37:22",
"last_sleep_connected_ts": null,
"last_sleep_disconnected_ts": null,
"last_speed": null,
"latest_hdderror": {
"count": 0,
"first_ts": null,
"last_ts": null
},
"live_stream": {
"duration_month": 0,
"live_stream_access": true
},
"migration": false,
"modem": {
"imei": null,
"simcard_iccid": null
},
"modem_rssi": "0",
"no_sd_card": false,
"online": true,
"pending_company_profile": "Brian_DV6",
"sd_format": {
"geotab_user_id": null,
"num_reformats": null,
"sdformat_last_ts": null,
"sdformat_status": null,
"user_id": null
},
"sd_status": {},
"sd_wear": 91.0,
"serial_number": "864839041706900",
"sleep": 0,
"tag_plate": null,
"timezone": null,
"uploaded_company_profile": "Brian_DV6",
"vehicle_icon": "van",
"vehicle_icon_size": false,
"vehicle_name": "Test TT DV6",
"vin_number": ""
}
],
"total_number": 28
},
"result": "OK"
}Modified at 2026-06-23 16:58:01