1. Event
RoscoLive API v1.0
  • Company
    • Create a company
      PUT
    • Get a company by ID
      GET
    • Update company
      POST
    • Get a company
      GET
    • Get companies
      GET
    • get partner companies list
      GET
    • Get own partner company
      GET
  • Device
    • Get a device
      GET
    • Get list of company devices
      GET
  • Device Firmware
    • get available firmware versions
      GET
    • get list of latest firmware versions
      GET
    • push firmware to device
      POST
    • cancel pending firmware update to devices
      DELETE
    • get firmware updates history for company
      GET
  • Driver Scoring / Coaching
    • Get company drivers list
      GET
    • Add new driver to company
      PUT
  • Event
    • Get Company Events
      GET
    • Request videos of an event
      PUT
    • Get Latest Event for Each Device in Company
      GET
    • get geotab events
      GET
    • Get a last updated event of devices
      GET
    • update an event
      POST
  • Live streaming
    • start live streaming
      GET
  • Report
    • get list of companies with data usage for date range
  • User
    • Update notification by email
    • Get event / sms notification settings
  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
Add new driver to company
Next
Request videos of an event
Built with