1. Event
RoscoLive API v1.0(v2.41.0)
  • Authentication
    • Login
      POST
    • Logout
      GET
  • Report
    • Get custom report data
      GET
    • Get paired GO device report
      GET
    • Update custom report
      POST
    • Create custom report for user
      PUT
  • Company
    • private
      • Create a new partner company
      • Update partner company info
      • Get a partner company
      • Disable a customer company
      • Enable a customer company
      • Disable a partner company
      • Enable a partner company
    • Create a company
      PUT
    • Get a company by ID
      GET
    • Update company
      POST
    • Get a company
      GET
    • Get companies
      GET
    • Get own partner company
      GET
  • Remote Device Management
    • Get device config history
      GET
    • Get device config history file
      GET
  • Device
    • Search devices
      GET
    • Update a device settings
      POST
    • Get a device
      GET
    • Get list of company devices
      GET
    • Get device with driver ID
      GET
    • Create devices (auto-prov/DV4/DV6/DV7)
      PUT
    • Get devices for all companies available for user
      GET
    • Get device list for multiple companies
      GET
    • Get current activity status of devices
      GET
  • Driver Scoring / Coaching
    • Get company event score weights
    • Update company event score weights
  • Event
    • Get Company Events
      GET
    • Get Latest Event for Each Device in Company
      GET
    • Share an event
      PUT
    • Get a last updated event of devices
      GET
    • Get list of company events
      GET
  • External Service
    • BeWhere
      • Get BeWhere trackers by group
      • Add BeWhere tracker to group
      • Remove BeWhere tracker from group
      • Get list of BeWhere trackers for a company
      • Get available dates for a BeWhere tracker
      • Get metadata for a BeWhere tracker
  • Group
    • Get devices of a group
  • Metadata
    • Get alerts and events of devices for company
    • Get alerts of a device
  • Webhooks
    • Add Webhook Subscription to Multiple Event Types
    • Get Notification Subscriptions for Event Type
    • Set Notifications for Event Type
    • Remove Notification Subscription for Event Type
    • Get All Webhook Subscriptions for a Company
  • Installer App
    • Get user installed devices
  1. Event

Get list of company events

GET
/companies/{company_id}/events/list
Endpoint to get all company events for the specified company_id within a specific time period.

User Role Permissions#

The following table shows which user roles are allowed to send requests using this API endpoint.
RolePermission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Path Params

Query Params

Responses

🟢200Success
application/json
Bodyapplication/json

🟠400Invalid datetime format
🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/companies//events/list?start_ts=undefined&end_ts=undefined&page_number=undefined&page_size=undefined&order=undefined&direction=undefined&device_ids=undefined&exclude_device_ids=undefined&include_data=undefined&filters=undefined&rules=undefined&event_types=&is_deleted=undefined&is_flood=undefined&is_data_usage_locked=undefined&event_ids=undefined&group_ids=undefined&search=undefined&search_driver=undefined&search_type=undefined&video_statuses=undefined&geotab_sn=undefined&geotab_email=undefined&channels=undefined'
Response Response Example
200 - Example 1
{
    "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"
}
Modified at 2026-08-26 17:01:28
Previous
Get a last updated event of devices
Next
Get BeWhere trackers by group
Built with