- 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
- Custom Role Permissions
- Device
- Get reported DTCs for devicesGET
- 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
- 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
Get devices for all companies available for user
GET
/devices/list
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
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?include_data=&page_number=&page_size=&du_start_ts&du_end_ts'Responses
🟢200Success
application/json
Body
Example
{
"meta": {
"code": 200
},
"response": {
"devices": [
{
"activated_timestamp": "2025-05-02 10:15:19",
"active": true,
"adas_camera_height": 150.0,
"adas_camera_offset": 0.0,
"adas_units": "imperial",
"adas_vehicle_hood_len": 0.0,
"adas_vehicle_width": 172.13,
"asset_id": 4149,
"camera_health": {
"crit": 0,
"unacknowledged": 202,
"unacknowledged_sd20": 0,
"warn": 4,
"warn_sd20": 0
},
"canbus": "4",
"channel_available": "1,2",
"channel_status": [
{
"channel": 1,
"check_type": "live",
"fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/3539397876/failure_channels/1_black.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=4C2llUb%2BGzGd7q4HGkjjYu8I8z0%3D&Expires=1756655876",
"fail_status": "black",
"fail_ts": "2025-07-09 01:42:08",
"success_ts": "2025-07-09 10:42:14"
},
{
"channel": 2,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2025-07-09 10:42:14"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 2,
"data_limit": 1,
"data_usage": 180772905,
"data_usage_live_stream": 3800169,
"device_id": "3539397876",
"device_type": "dv6",
"disable_live_stream": false,
"driver_id": null,
"driver_name": null,
"firmware_status": "latest firmware",
"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": true,
"group_name": "Installed Devices",
"ignition": null,
"installed_id": null,
"last_connected_ts": "2025-07-31 08:50:55",
"last_disconnected_ts": "2025-07-31 08:49:54",
"last_sleep_connected_ts": null,
"last_sleep_disconnected_ts": null,
"latest_hdderror": {
"count": 4,
"first_ts": "2025-05-06 09:08:30",
"last_ts": "2025-07-09 10:51:13"
},
"live_stream": {
"duration_month": 99,
"live_stream_access": null
},
"modem": {
"imei": "864839040973196",
"simcard_iccid": "89148000005541553129"
},
"modem_rssi": "0",
"no_sd_card": false,
"online": true,
"partner_name": "Rosco Vision Partner",
"pending_company_profile": "Default",
"sd_format": {
"geotab_user_id": null,
"num_reformats": null,
"sdformat_last_ts": null,
"sdformat_status": null,
"user_id": null
},
"sd_status": {},
"serial_number": "864839041706900",
"sleep": 0,
"tag_plate": null,
"timezone": null,
"uploaded_company_profile": "Default",
"vehicle_icon": "van",
"vehicle_name": "test FWSD-7926 task",
"vin_number": ""
},
{
"activated_timestamp": "2024-03-20 13:33:33",
"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": 4104,
"camera_health": {
"crit": 0,
"unacknowledged": 0,
"unacknowledged_sd20": 0,
"warn": 0,
"warn_sd20": 0
},
"canbus": "0",
"channel_available": "1,2,3",
"channel_status": [
{
"channel": 1,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2024-04-01 18:56:19"
},
{
"channel": 2,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2024-04-01 18:51:18"
},
{
"channel": 3,
"check_type": null,
"fail_status": null,
"fail_ts": null,
"success_ts": "2024-04-01 18:56:19"
}
],
"company_id": "825",
"company_name": "Rosco-Geotab1",
"config_checksum": 1,
"data_limit": 1,
"data_usage": 0,
"data_usage_live_stream": 0,
"device_id": "3917147185",
"device_type": "dv6",
"disable_live_stream": false,
"driver_id": null,
"driver_name": null,
"firmware_status": "firmware out of date",
"firmware_version": {
"firmware": "v2.6.0",
"gps": null,
"mcu": "88",
"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": "Installed Devices",
"ignition": {
"state": true,
"ts": "2024-04-03 13:07:22"
},
"installed_id": null,
"last_connected_ts": "2024-04-03 13:07:43",
"last_disconnected_ts": "2024-04-03 13:10:13",
"last_sleep_connected_ts": null,
"last_sleep_disconnected_ts": null,
"latest_hdderror": {
"count": 0,
"first_ts": null,
"last_ts": null
},
"live_stream": {
"duration_month": 0,
"live_stream_access": null
},
"modem": {
"imei": "15974000149905",
"simcard_iccid": "89148000008883518858"
},
"modem_rssi": "-51",
"no_sd_card": false,
"online": false,
"partner_name": "Rosco Vision Partner",
"pending_company_profile": "dcam test",
"sd_format": {
"geotab_user_id": null,
"num_reformats": null,
"sdformat_last_ts": null,
"sdformat_status": null,
"user_id": null
},
"sd_status": {},
"serial_number": "015974000149905",
"sleep": 0,
"tag_plate": null,
"timezone": null,
"uploaded_company_profile": "tttttt",
"vehicle_icon": "van",
"vehicle_name": "TestDV6",
"vin_number": ""
}
],
"total_number": 4045
},
"result": "OK"
}🟠400Invalid datetime format
🟠401Login Required
Modified at 2025-11-03 19:05:21