Get device list for multiple companies
GET
/devices/list/search
du_start_ts or du_end_ts (or both) are not provided, the data_usage range defaults to the current month.The maximum allowed time range for
data_usage is 1 year, meaning the difference between du_start_ts and du_end_ts must not exceed one year.User Role Permissions
| Role | Permission |
|---|---|
| Partner | |
| Partner View | |
| Custom Partner | |
| Fleet Manager | |
| Group Manager | |
| User | |
| Custom User |
Request
Query Params
Cookie Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/devices/list/search?company_ids=&include_data=undefined&page_number=undefined&page_size=undefined&search_fields=&search_str=&order_fields=&order_dir=undefined&search_condition=undefined&du_start_ts=undefined&du_end_ts=undefined' \
--header 'Cookie: session={{session}};session_token={{session_token}}'Response Response Example
200 - Get devices with "search_condition"="and" param (Request: /devices/list/search?company_ids=825&page_number=1&page_size=20&order_fields=vehicle_name&order_dir=asc&search_fields=vehicle_name,device_id&search_str=Ford 150,35174862&search_condition=and)
{
"meta": {
"code": 200
},
"response": {
"devices": [
{
"activated_timestamp": "2018-08-07 16:37:50",
"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,
"canbus": "0",
"channel_available": "1,2,3",
"channel_status": [
{
"channel": 1,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/51794261/failure_channels/1_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=nWcQn2hryqoHJIzzNgdrMiEj%2BO4%3D&Expires=1765038944",
"fail_status": "black",
"fail_ts": "2025-07-09 21:56:37",
"misalignment": true,
"success_ts": "2025-10-03 14:00:28"
},
{
"channel": 2,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/51794261/failure_channels/2_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=AIBAnuYLPVtG25kNBedfi6zeN40%3D&Expires=1765038944",
"fail_status": "black",
"fail_ts": "2025-07-10 12:26:38",
"success_ts": "2025-10-03 14:00:29"
},
{
"channel": 3,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/51794261/failure_channels/3_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=g%2F9i4731WfHHt4HNQOlNW7%2BVicg%3D&Expires=1765038944",
"fail_status": "black",
"fail_ts": "2025-01-14 10:55:19",
"success_ts": "2025-10-03 14:00:29"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 1,
"data_limit": 2,
"device_id": "35174862",
"device_type": "dv4",
"disable_live_stream": false,
"general_status": null,
"gps_online": false,
"group_name": "Non-Paired Devices",
"incorrect_device_time": false,
"installed_id": null,
"last_connected_ts": "2021-05-05 14:36:00",
"last_disconnected_ts": "2021-05-05 16:39:50",
"last_sleep_connected_ts": null,
"last_sleep_disconnected_ts": null,
"online": false,
"pending_company_profile": null,
"serial_number": null,
"sleep": 0,
"tag_plate": null,
"timezone": "US/Eastern",
"uploaded_company_profile": null,
"vehicle_icon": "1",
"vehicle_icon_size": false,
"vehicle_name": "Ford 150",
"vin_number": null
}
],
"total_number": 1
},
"result": "OK"
}Modified at 2026-06-23 17:07:45