1. Event
RoscoLive API v1.0
  • Device
    • Get device list for multiple companies
      GET
    • Get current activity status of devices
      GET
  • Driver Scoring / Coaching
    • Get company event score weights
      GET
    • Update company event score weights
      POST
  • Event
    • Get Company Events
      GET
    • Request videos of an event
      PUT
    • Get Device Events for Period
      GET
  • Fleet Configuration
    • Create new profile in a company
      POST
    • Get a company profile
      GET
  • Metadata
    • Get alerts and events of devices for company
      GET
  • Report
    • Get custom report data
      GET
    • Get all events report for company
      GET
    • Get event count summary report for company devices
      GET
    • Update custom report
      POST
    • Create custom report for user
      PUT
  • User
    • Get User Info from Email Address
      GET
    • Get my Own User Info
      GET
    • Get application notifications
      GET
    • SD card reformat reminder
      POST
    • Update notification by email
      POST
    • Get event / sms notification settings
      GET
  1. Event

Get Device Events for Period

GET
https://fleet.roscolive.com/api/v1.0/devices/{device_id}/events
View all the events of a device in a specific time period.
If the page_number parameter is provided without page_size, the response will use the default page_size value to determine the number of records (events) returned. If neither page_number nor page_size are provided, the response will return all available device events.

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

🟢200200
application/json
Bodyapplication/json

🟠400400 (incorrect device id)
🟠404404 (device doesn't exist)
🟠400400 (incorrect type_filter)
🟠400400 (incorrect order))
🟠400400 (incorrect direction)
🟠400Invalid datetime format
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/devices/12345678/events?start_ts=20250801000000&end_ts=20250819235959&page_number=&page_size=&filter_type=&filter_exclude_type=&order=&direction=&include_data=undefined'
Response Response Example
200 - Valid get events for a device
{
    "meta": {
        "code": 200
    },
    "response": {
        "events": [
            {
                "accurate_duration": null,
                "asset_id": null,
                "company_id": 825,
                "created_by": 6294,
                "createtime": "Thu, 15 May 2025 07:31:42 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3539397876",
                "driver_card_id": null,
                "driver_id": null,
                "driver_name": "",
                "duration": 300,
                "email_sent": "alert",
                "end_ts": "Wed, 14 May 2025 08:20:00 GMT",
                "event_display_type": null,
                "event_label": null,
                "event_type": "SNAPSHOTS_CLIP",
                "event_type_specification": null,
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "Installed Devices"
                ],
                "has_feedback": false,
                "has_review": false,
                "hash": "5e90934553cb49e782521a73891dcacc",
                "id": 2630276,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": null,
                "last_reviewed_by": null,
                "last_viewed": null,
                "last_viewed_by": null,
                "lat": null,
                "lon": null,
                "meta_json": false,
                "mp4_1": false,
                "mp4_2": false,
                "mp4_3": false,
                "mp4_4": false,
                "nvr_filename": null,
                "old_device_id": null,
                "rule": null,
                "size": 0.6955,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630276/1_1.jpeg?...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630276/2_1.jpeg?...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Wed, 14 May 2025 08:15:00 GMT",
                "status": "used",
                "timestamp": "Wed, 14 May 2025 08:15:00 GMT",
                "type": "Custom Clip",
                "uploaded_timestamp": null,
                "uploading_status": null,
                "vehicle_name": "Test TT1",
                "video_option": "snapshot_only"
            },
            {
                "accurate_duration": 294,
                "asset_id": null,
                "company_id": 825,
                "created_by": 534,
                "createtime": "Tue, 20 May 2025 08:54:08 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3539397876",
                "driver_card_id": "0",
                "driver_id": null,
                "driver_name": "",
                "duration": 299,
                "email_sent": "alert",
                "end_ts": "Tue, 20 May 2025 02:19:59 GMT",
                "event_display_type": null,
                "event_label": null,
                "event_type": "SYSTEMADMIN_CLIP",
                "event_type_specification": null,
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "Installed Devices"
                ],
                "has_feedback": false,
                "has_review": false,
                "hash": "a40fee4842074f888d021173a63525c6",
                "id": 2630619,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": null,
                "last_reviewed_by": null,
                "last_viewed": 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": "0000000000135755-250519-221459-221959-10O400000002.nvr",
                "old_device_id": null,
                "rule": null,
                "size": 292.1456,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630619/1.jpeg?...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630619/2.jpeg?...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Tue, 20 May 2025 02:15:00 GMT",
                "status": "used",
                "timestamp": "Tue, 20 May 2025 02:15:00 GMT",
                "type": "Custom Clip",
                "uploaded_timestamp": "Tue, 20 May 2025 10:43:05 GMT",
                "uploading_status": "VIDEO_UPLOADED",
                "vehicle_name": "Test TT1",
                "video_option": null
            }
        ],
        "total_number": 2
    },
    "result": "OK"
}
Modified at 2026-08-26 17:01:28
Previous
Request videos of an event
Next
Create new profile in a company
Built with