1. Event
RoscoLive API v1.0
  • Device
    • Get a device
      GET
  • Driver Scoring / Coaching
    • Get drivers coaching events
      GET
  • Event
    • Get Company Events
      GET
    • Get Flagged Company Events
      GET
    • Request custom video from device
      PUT
    • Add event label
      POST
    • Add user feedback to event
      POST
    • Get event user feedback
      GET
    • Get event filters list for date range in company
      GET
  1. Event

Get Company Events

GET
/partners/companies/{company_name}/events
Get all events of company named company_name 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

🟢200Valid get company events
application/json
Bodyapplication/json

🟠400Get company events with invalid start_ts
🟠404Get company events with non existing company
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/partners/companies//events?start_ts=20240728092243&end_ts=20240728160819&order=vehicle_name&direction=asc&search=&filters=gsensor%2Cspeed&page_number=2&page_size=50&search_by_id=false&search_type=vehicle&is_deleted=false&device_ids=12345%2C67890&exclude_device_ids=98765%2C43210&feedback=false&channels=&include_data=undefined'
Response Response Example
200 - Valid get company events
{
    "meta": {
        "code": 200
    },
    "response": {
        "events": [
            {
                "accurate_duration": 10,
                "asset_id": null,
                "company_id": 825,
                "created_by": 0,
                "createtime": "Wed, 04 Jun 2025 02:24:55 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3595522191",
                "driver_card_id": null,
                "driver_email": null,
                "driver_id": null,
                "driver_name": null,
                "duration": 10,
                "email_sent": "alert",
                "end_ts": "Wed, 04 Jun 2025 02:25:06 GMT",
                "event_display_type": "",
                "event_label": null,
                "event_notes": null,
                "event_type": "Distraction",
                "event_type_specification": null,
                "flagged": false,
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "InternalTrialDV6"
                ],
                "has_feedback": true,
                "has_review": true,
                "hash": "1ac56d2740eb11f0bc14069d5833a13f",
                "id": 2630755,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": "Wed, 11 Jun 2025 17:09:32 GMT",
                "last_reviewed_by": 534,
                "last_reviewed_name": "John Malkovich",
                "last_viewed": {
                    "viewed_ts": null,
                    "viewer": {
                        "first_name": null,
                        "last_name": null
                    }
                },
                "last_viewed_by": null,
                "lat": 40.6359,
                "lon": -74.198,
                "meta_json": true,
                "mp4_1": true,
                "mp4_2": true,
                "mp4_3": true,
                "mp4_4": false,
                "nvr_filename": "0000000000089003-250603-222456-222506-10U700000022.nvr",
                "old_device_id": null,
                "rule": null,
                "size": 16.6537,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_3": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Wed, 04 Jun 2025 02:24:56 GMT",
                "status": "used",
                "timestamp": "Wed, 04 Jun 2025 02:25:01 GMT",
                "type": "Distraction",
                "uploaded_timestamp": "Wed, 04 Jun 2025 02:26:32 GMT",
                "uploading_status": "VIDEO_UPLOADED",
                "vehicle_name": "Gary New2 Volvo",
                "video_option": "video_snapshot"
            }
        ],
        "total_number": 1
    },
    "result": "OK"
}
Modified at 2026-06-23 15:13:49
Previous
Get drivers coaching events
Next
Get Flagged Company Events
Built with