- Authentication
- Company
- Get Camera Health Errors for Company
- Create a company
- get partner settings
- get audit logs of a company
- get input sensors notifications of a company
- get ignition notifications of a company
- Get a company by ID
- update a company by ID
- Update company
- search companies
- get companies list
- Get a company
- Get companies
- get partner companies list
- Get own partner company
- Get profile update devices states
- Get profile update devices
- Export profile updates progress
- Create zone
- Update zone
- Delete zone
- Get zones for company
- Get zone movements
- Get zone movements by vehicle
- Custom Role Permissions
- Device
- Get reported DTCs for devicesGET
- Get pre-selected devicesGET
- Store pre-selected devicesPOST
- Migrate devices to another companyPOST
- Get all device migrations for a companyGET
- Cancel device migrations for a companyPOST
- Get company devicesGET
- Search devicesGET
- Update a device settingsPOST
- get a device data usageGET
- Play in-cab audible alert sound for devicePOST
- get devices data usageGET
- get a company devices by company IDGET
- restart a deviceGET
- get company devices with modemsGET
- get distanceGET
- get installed report of a deviceGET
- get an installed reportGET
- merge profile with device configPOST
- get audit logs of a deviceGET
- Get list of trip dates for deviceGET
- Get list of trips for passed device and dateGET
- Get a deviceGET
- Get list of company devicesGET
- get device with driver idGET
- create devices (legacy/DV4)PUT
- Create devices (auto-prov/DV6)PUT
- get company device using IMEI/SNGET
- check red bubble in manage vehiclesGET
- Bulk device creationPUT
- Get devices for all companies available for userGET
- get list of trip related snapshotsGET
- reset status of sd cardPOST
- get list of all available datesGET
- Get available video list for dateGET
- Replace devicePOST
- get replace history by device idGET
- clear device channel statusPOST
- get camera health error by device idGET
- get camera health definitionsGET
- update camera health error by error idPOST
- update camera health errorsPOST
- Get device list for multiple companiesGET
- Get current activity status of devicesGET
- Get reported DTCs for devices
- Device Firmware
- Driver Scoring / Coaching
- get company drivers list
- get a list of trips
- associate a driver with a trip
- get driver by event_id
- update a driver
- get driver by trip_photo_id
- Get driver scores
- add driver photo
- Add New Driver to Company
- remove a driver
- upload a driver from csv file
- Get unknown driver trips
- associate trip with the driver.
- Get company event score weights
- Update company event score weights
- Get drivers coaching events
- Event
- Request Custom Snapshots for Time Range
- Request Custom Event
- Get an Event of a Device by Start Time
- Get an Event by ID and Storage Type
- Get Company Events
- Get Event by Company and ID
- Send an event
- get status of an event
- Request videos of an event
- Get Uploaded Event Videos
- get events summary of devices
- get events summary of a device
- get a company events by company ID
- get status of an event by company ID
- Get Event Snapshots
- get snapshots of an event or alert by company ID
- Get a last device event
- Get Latest Event for Each Device in Company
- get events log of a device
- get dates of events
- get events for charts and graphs
- get events for charts and graphs by company ID
- get an event by company ID
- get events summary of a device by company ID
- request videos of an event by company ID
- get dates of an events by company ID
- get a last event of company device
- clear last event
- get dates of events of a device
- Update Custom Event
- delete an event
- request videos of an alert
- share an event
- Get an event by a permalink
- get geotab events
- Get a last updated event of devices
- download a blocked event
- Get Flagged Company Events
- flag an event
- unflag an event
- generate snapshots
- local geocoding service
- update an event
- Get snapshot/location of event
- Get Device Events for Period
- Request custom video from device
- get snapshot on demand
- Get an event by a permalink hash
- Set Event Label for Event
- Restore event video from archive
- Add users for notification of event restore from archive
- Add event label
- Add user feedback to event
- Get event user feedback
- Get event filters list for date range in company
- External Service
- Fleet Configuration
- Group
- get company groups
- add a group
- remove a group
- get devices of a group
- add a device to a group
- remove a device from a group
- get users of a group
- add a user to a group
- remove a user from a group
- get company groups by company ID
- add a device to a group by company ID
- Get devices of a group
- remove a device from a group by company ID
- remove a group by company ID
- add a group by company ID
- add an user to a group by company ID
- get users of a group by company ID
- remove an user from a group by company ID
- edit group
- get groups with ID
- get group of a company by group ID
- Live streaming
- Metadata
- Modem Administration
- Report
- get data usage report
- Get custom report data
- get data usage report by device id
- get list of companies with data usage for date range
- get data usage for active devices for specified companies
- get companies with data usage for date range
- get data usage report for devices in company
- get data tracking report
- Request IFTA report of a company
- Get IFTA report of a company
- Get IFTA report in CSV-file by company
- get all events report
- Get all events report for company
- get vehicle activity report
- get firmware report
- Get event count summary report for company devices
- get driver event breakdown report
- get driver event performance report
- Update custom report
- get custom reports by user email
- get custom report by report id
- put subscribe to a report
- get report subscriptions
- get list of standard reports
- get speeding summary report
- get speeding breakdown report
- get idling summary report
- get idling breakdown report
- Create custom report for user
- Partner Portal
- Releases
- Remote Device Management
- Statistics
- User
- Record map type usage
- Get Company Users
- Get User Info from Email Address
- Update a User's Info
- remove a user
- Get my Own User Info
- Create a User
- Get Users by Company ID
- get user settings
- set user settings
- Get application notifications
- remove the notification
- mark notifications as viewed
- verify password
- SD card reformat reminder
- Update notification by email
- assign user to company
- get permissions by a user_id
- Get event / sms notification settings
- Webhooks
- Asset
- Schemas
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
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/devices/list/search?company_ids=&include_data&page_number&page_size&search_fields=&search_str=&order_fields=&order_dir&search_condition&du_start_ts&du_end_ts' \
--header 'Cookie: session={{session}};session_token={{session_token}}'Responses
🟢200Success
application/json
Body
Examples
{
"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",
"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_name": "Ford 150",
"vin_number": null
}
],
"total_number": 1
},
"result": "OK"
}🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Modified at 2025-12-09 18:30:36