- 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 devices
- Get pre-selected devices
- Store pre-selected devices
- Migrate devices to another company
- Get all device migrations for a company
- Cancel device migrations for a company
- Get company devices
- Search devices
- Update a device settings
- get a device data usage
- Play in-cab audible alert sound for device
- get devices data usage
- get a company devices by company ID
- restart a device
- Get company devices with modems
- get distance
- get installed report of a device
- get an installed report
- merge profile with device config
- get audit logs of a device
- Get list of trip dates for device
- Get list of trips for passed device and date
- Get a device
- Get list of company devices
- get device with driver id
- create devices (legacy/DV4)
- Create devices (auto-prov/DV4/DV6/DV7)
- get company device using IMEI/SN
- check red bubble in manage vehicles
- Bulk device creation
- Get devices for all companies available for user
- get list of trip related snapshots
- reset status of sd card
- get list of all available dates
- Get available video list for date
- Replace device
- get replace history by device id
- clear device channel status
- get camera health error by device id
- get camera health definitions
- update camera health error by error id
- update camera health errors
- Get device list for multiple companies
- Get current activity status of devices
- Device Firmware
- Driver Scoring / Coaching
- Get driver scans
- 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 RangePUT
- Request Custom EventPUT
- Get an Event of a Device by Start TimeGET
- Get an Event by ID and Storage TypeGET
- Get Company EventsGET
- Get Event by Company and IDGET
- Send an eventPUT
- get status of an eventGET
- Request videos of an eventPUT
- Get Uploaded Event VideosGET
- get events summary of devicesGET
- get events summary of a deviceGET
- get a company events by company IDGET
- get status of an event by company IDGET
- Get Event SnapshotsGET
- get snapshots of an event or alert by company IDGET
- Get a last device eventGET
- Get Latest Event for Each Device in CompanyGET
- get events log of a deviceGET
- get dates of eventsGET
- get events for charts and graphsGET
- get events for charts and graphs by company IDGET
- get an event by company IDGET
- get events summary of a device by company IDGET
- request videos of an event by company IDPUT
- get dates of an events by company IDGET
- get a last event of company deviceGET
- clear last eventDELETE
- get dates of events of a deviceGET
- Update Custom EventPOST
- delete an eventDELETE
- request videos of an alertPUT
- share an eventPUT
- Get an event by a permalinkGET
- get geotab eventsGET
- Get a last updated event of devicesGET
- download a blocked eventPOST
- Get Flagged Company EventsGET
- flag an eventPUT
- unflag an eventDELETE
- generate snapshotsPUT
- local geocoding serviceGET
- update an eventPOST
- Get snapshot/location of eventGET
- Get Device Events for PeriodGET
- Request custom video from devicePUT
- get snapshot on demandGET
- Get an event by a permalink hashGET
- Set Event Label for EventPOST
- Restore event video from archivePOST
- Add users for notification of event restore from archivePOST
- Add event labelPOST
- Add user feedback to eventPOST
- Get event user feedbackGET
- Get event filters list for date range in companyGET
- Get list of company eventsGET
- Request Custom Snapshots for Time Range
- 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 list of company events
GET
/companies/{company_id}/events/list
company_id within a specific time period.User Role Permissions#
| Role | Permission |
|---|---|
| Partner | |
| Partner View | |
| Custom Partner | |
| Fleet Manager | |
| Group Manager | |
| User | |
| Custom User |
Request
Path Params
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/companies//events/list?start_ts&end_ts&page_number&page_size&order&direction&device_ids&exclude_device_ids&include_data&rules&event_types&is_deleted&is_flood&is_data_usage_locked&event_ids&group_ids&search&search_driver&search_type&video_statuses&geotab_sn&geotab_email&channels'Responses
🟢200Success
application/json
Body
Example
{
"meta": {
"code": 200
},
"response": {
"events": [
{
"accurate_duration": 240,
"asset_id": null,
"company_id": 825,
"create_time": "Fri, 13 Mar 2026 15:40:09 GMT",
"created_by": 6992,
"data": null,
"device_id": "3595522191",
"driver_card_id": null,
"driver_email": null,
"driver_id": null,
"driver_name": null,
"duration": 240,
"email_sent": "alert",
"end_ts": "Fri, 13 Mar 2026 15:38:00 GMT",
"event_display_type": null,
"event_label": null,
"event_notes": null,
"event_type": "SYSTEMADMIN_CLIP",
"event_type_specification": null,
"flagged": false,
"geotab_driver": null,
"geotab_user_id": null,
"groups": [
"EngineeringDV6"
],
"has_feedback": false,
"has_review": false,
"hash": "f8730ba3202242d99012508fc1ac22b1",
"id": 2651235,
"impact_score": true,
"is_data_usage_locked": false,
"is_flood": false,
"last_reviewed": null,
"last_reviewed_by": null,
"last_reviewed_name": null,
"last_viewed": {
"viewed_ts": null,
"viewer": {
"first_name": null,
"last_name": null
}
},
"last_viewed_by": null,
"lat": null,
"lon": null,
"meta_json": true,
"mp4_1": true,
"mp4_2": true,
"mp4_3": false,
"mp4_4": false,
"nvr_filename": "0000000000158447-260313-113359-113800-10O400000002.nvr",
"old_device_id": null,
"rule": null,
"size": 106742307.0,
"snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3595522191/2651235/1.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=48%2F0KiZ%2BMvgQvAmP%2BcwQB8LLog4%3D&Expires=2088785866",
"snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3595522191/2651235/2.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=XzisheKz1NWtuCudKojxrnuYGGI%3D&Expires=2088785866",
"snapshot_status": "SNAPSHOT_UPLOADED",
"start_ts": "Fri, 13 Mar 2026 15:34:00 GMT",
"status": "used",
"timestamp": "Fri, 13 Mar 2026 15:34:00 GMT",
"type": "Custom Clip",
"uploaded_timestamp": "Fri, 13 Mar 2026 15:40:39 GMT",
"uploading_status": "VIDEO_UPLOADED",
"vehicle_name": "Gary New2 Volvo",
"video_option": null
},
{
"accurate_duration": 295,
"asset_id": null,
"company_id": 825,
"create_time": "Fri, 13 Mar 2026 15:32:22 GMT",
"created_by": 6992,
"data": null,
"device_id": "3595522191",
"driver_card_id": null,
"driver_email": null,
"driver_id": 2883,
"driver_name": "fname Self ID 2 lname Self ID 2",
"duration": 300,
"email_sent": "alert",
"end_ts": "Fri, 13 Mar 2026 14:31:00 GMT",
"event_display_type": null,
"event_label": null,
"event_notes": null,
"event_type": "SYSTEMADMIN_CLIP",
"event_type_specification": null,
"flagged": false,
"geotab_driver": null,
"geotab_user_id": null,
"groups": [
"EngineeringDV6"
],
"has_feedback": false,
"has_review": false,
"hash": "c0f63edfdc134c828d42c84249a7e527",
"id": 2651233,
"impact_score": true,
"is_data_usage_locked": false,
"is_flood": false,
"last_reviewed": null,
"last_reviewed_by": null,
"last_reviewed_name": null,
"last_viewed": {
"viewed_ts": null,
"viewer": {
"first_name": null,
"last_name": null
}
},
"last_viewed_by": null,
"lat": null,
"lon": null,
"meta_json": true,
"mp4_1": true,
"mp4_2": true,
"mp4_3": false,
"mp4_4": false,
"nvr_filename": "0000000000158381-260313-102558-103100-10O400000002.nvr",
"old_device_id": null,
"rule": null,
"size": 248454316.0,
"snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3595522191/2651233/1.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=24lJDUF0M95Ml1OZcBP%2BFyZLL98%3D&Expires=2088785866",
"snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3595522191/2651233/2.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=7CDMeyOZGcXG9DENPBVcx5WW0EM%3D&Expires=2088785866",
"snapshot_status": "SNAPSHOT_UPLOADED",
"start_ts": "Fri, 13 Mar 2026 14:26:00 GMT",
"status": "used",
"timestamp": "Fri, 13 Mar 2026 14:26:00 GMT",
"type": "Custom Clip",
"uploaded_timestamp": "Fri, 13 Mar 2026 15:33:53 GMT",
"uploading_status": "VIDEO_UPLOADED",
"vehicle_name": "Gary New2 Volvo",
"video_option": null
}
],
"total_number": 138
},
"result": "OK"
}🟠400Invalid datetime format
🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Modified at 2026-04-01 15:51:54