- 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
Search devices
GET
/partners/devices/search
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/partners/devices/search?keyword='Responses
🟢200valid search devices
application/json
Body
Example
{
"meta": {
"code": 200
},
"response": {
"devices": [
{
"activated_timestamp": "Tue, 31 Aug 2021 20:49:03 GMT",
"active": true,
"adas_camera_height": 150,
"adas_camera_offset": 0,
"adas_units": "imperial",
"adas_vehicle_hood_len": 150,
"adas_vehicle_width": 170,
"ads_online": false,
"asset_id": 457,
"canbus": "4",
"cardreader": true,
"channel_available": "1,2",
"config_checksum": 1,
"created_at": "Tue, 31 Aug 2021 20:44:39 GMT",
"data_limit": 1,
"data_online": false,
"device_id": "3481785188",
"device_type": "dv6",
"disable_live_stream": false,
"driver_name": null,
"driver_recognition": "company_setting",
"exceeded_livestream_limit": false,
"firmware": "v2.2.0",
"flood_blocked": true,
"general_status": null,
"groups": [
"EngineeringDV6"
],
"installed_by_user_id": 5399,
"is_flagged": false,
"last_disconnected_ts": "Thu, 17 Feb 2022 20:28:20 GMT",
"live_online": false,
"no_sd_card": false,
"obd": "2",
"online_gps": false,
"parking_duration": 120,
"pending_company_profile": "Manual",
"pending_config_status": "pending",
"pending_profile_id": null,
"previous_company_token": "77987163",
"profile_id": 0,
"serial_number": "301684914858730",
"sleep": 0,
"status": "used",
"tag_plate": "6546546",
"timezone": "US/Eastern",
"uploaded_company_profile": "Manual",
"vehicle_icon": "van",
"vehicle_name": "test geotab replace",
"vin_number": "3C4PDCAB1DT733350"
},
{
"active": true,
"adas_camera_height": 150,
"adas_camera_offset": 0,
"adas_units": "imperial",
"adas_vehicle_hood_len": 0,
"adas_vehicle_width": 170,
"ads_online": false,
"asset_id": 4160,
"canbus": "0",
"cardreader": null,
"channel_available": "1,2",
"config_checksum": 0,
"created_at": "Wed, 16 Jul 2025 16:19:00 GMT",
"data_limit": 1,
"data_online": false,
"device_id": "3765218999",
"device_type": "dv6",
"disable_live_stream": false,
"driver_name": null,
"driver_recognition": "company_setting",
"exceeded_livestream_limit": false,
"firmware": null,
"flood_blocked": false,
"general_status": null,
"groups": [
"API test group"
],
"installed_by_user_id": 534,
"is_flagged": false,
"live_online": false,
"no_sd_card": false,
"online_gps": false,
"parking_duration": 60,
"pending_company_profile": "test 5091",
"pending_config_status": null,
"pending_profile_id": 13063,
"serial_number": "459651389158730",
"sleep": 0,
"status": "used",
"tag_plate": "ABC123",
"uploaded_company_profile": null,
"vehicle_icon": "van",
"vehicle_name": "device_to_test_FWSD-7965",
"vin_number": "8U7G6F5D4W3S2X1V0L"
}
]
},
"result": "OK"
}🟠404search none existing device
🟠401Login Required
Modified at 2025-11-03 19:05:21