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 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 13:50:00
Previous
Update company event score weights
Next
Get Latest Event for Each Device in Company
Built with