RoscoLive API v1.0
  1. Event
RoscoLive API v1.0
  • Authentication
    • Login
    • Logout
    • mark eula as viewed
    • password change
    • password reset
  • Company
    • Get Camera Health Errors for Company
    • create a company
    • get partner settings
    • get audit logs of a company
    • get input sensors notifications of a company
    • get ignition notifications of a company
    • get a company by ID
    • update a company by ID
    • update company
    • search companies
    • get companies list
    • get a company
    • get companies
    • get partner companies list
    • get own partner company
  • Custom Role Permissions
    • get full list of available custom user permission
  • Device
    • get company devices
    • search devices
    • update a device
    • get a device data usage
    • Play in-cab audible alert sound for device
    • get devices data usage
    • get a company devices by company ID
    • restart a device
    • get company devices with modems
    • get distance
    • get installed report of a device
    • get an installed report
    • merge profile with device config
    • get audit logs of a device
    • get list of trip dates for device
    • get list of trips for passed device and date
    • Get a device
    • get list of company devices
    • get device with driver id
    • create devices (legacy/DV4)
    • create devices (auto-prov/DV6)
    • get company device using IMEI/SN
    • check red bubble in manage vehicles
    • bulk device creation
    • get devices for all companies available for user
    • get list of trip related snapshots
    • reset status of sd card
    • get list of all available dates
    • get available video list for date
    • replace device
    • get replace history by device id
    • clear device channel status
    • get camera health error by device id
    • get camera health definitions
    • update camera health error by error id
    • update camera health errors
    • Get device list for multiple companies
    • Get current activity status of devices
  • Device Firmware
    • get available firmware versions
    • get list of latest firmware versions
    • push firmware to device
    • cancel pending firmware update to devices
    • get firmware updates history for company
  • Driver Scoring / Coaching
    • get company drivers list
    • get a list of trips
    • associate a driver with a trip
    • get driver by event_id
    • update a driver
    • get driver by trip_photo_id
    • get driver scores
    • add driver photo
    • Add New Driver to Company
    • remove a driver
    • upload a driver from csv file
    • get unknown driver trips
    • associate trip with the driver.
    • Get company event score weights
    • Update company event score weights
    • Get drivers coaching events
  • Event
    • Request Custom Snapshots for Time Range
      PUT
    • Request Custom Event
      PUT
    • Get an Event of a Device by Start Time
      GET
    • Get an Event by ID and Storage Type
      GET
    • Get Company Events
      GET
    • Get Event by Company and ID
      GET
    • send an event
      PUT
    • get status of an event
      GET
    • Request videos of an event
      PUT
    • Get Uploaded Event Videos
      GET
    • get events summary of devices
      GET
    • get events summary of a device
      GET
    • get a company events by company ID
      GET
    • get status of an event by company ID
      GET
    • Get Event Snapshots
      GET
    • get snapshots of an event or alert by company ID
      GET
    • get a last event
      GET
    • Get Latest Event for Each Device in Company
      GET
    • get events log of a device
      GET
    • get dates of events
      GET
    • get events for charts and graphs
      GET
    • get events for charts and graphs by company ID
      GET
    • get an event by company ID
      GET
    • get events summary of a device by company ID
      GET
    • request videos of an event by company ID
      PUT
    • get dates of an events by company ID
      GET
    • get a last event of company device
      GET
    • clear last event
      DELETE
    • get dates of events of a device
      GET
    • Update Custom Event
      POST
    • delete an event
      DELETE
    • request videos of an alert
      PUT
    • share an event
      PUT
    • get an event by a permalink
      GET
    • get geotab events
      GET
    • get a last updated event of devices
      GET
    • download a blocked event
      POST
    • Get Flagged Company Events
      GET
    • flag an event
      PUT
    • unflag an event
      DELETE
    • generate snapshots
      PUT
    • local geocoding service
      GET
    • update an event
      POST
    • get snapshot/location of event
      GET
    • Get Device Events for Period
      GET
    • Request custom video from device
      PUT
    • get snapshot on demand
      GET
    • get an event by a permalink hash
      GET
    • Set Event Label for Event
      POST
    • Restore event video from archive
      POST
    • Add users for notification of event restore from archive
      POST
    • 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
  • External Service
    • Get an external service account
    • Pair RL device with external device
    • Get RL device data via external device unique serial number
    • external service login
    • get a device
  • Fleet Configuration
    • Get profiles of a company
    • Create new profile in a company
    • Get a company profile
    • get profile history
    • Update a company profile
  • Group
    • get company groups
    • add a group
    • remove a group
    • get devices of a group
    • add a device to a group
    • remove a device from a group
    • get users of a group
    • add a user to a group
    • remove a user from a group
    • get company groups by company ID
    • add a device to a group by company ID
    • get devices of a group by company ID
    • remove a device from a group by company ID
    • remove a group by company ID
    • add a group by company ID
    • add an user to a group by company ID
    • get users of a group by company ID
    • remove an user from a group by company ID
    • edit group
    • get groups with ID
    • get group of a company by group ID
  • Live streaming
    • start live streaming
    • stop live streaming
    • start multi-channel live streaming
    • stop multi-channel live streaming
  • Metadata
    • get metadata of a device
    • get metadata of devices
    • Get alerts and events of devices for company
    • get alerts for charts and graphs
    • get metadata of device(s) for last 24 hours
    • get alerts of a device
    • get alerts of a driver
  • Modem Administration
    • get list of available modems
    • upgrade modem firmware
    • upgrade modem firmware for group of devices
  • Report
    • get data usage report
    • Get custom report data
    • get data usage report by device id
    • get list of companies with data usage for date range
    • get data usage for active devices for specified companies
    • get companies with data usage for date range
    • get data usage report for devices in company
    • get data tracking report
    • get all events report
    • Get all events report for company
    • get vehicle activity report
    • get firmware report
    • Get event count summary report for company devices
    • get driver event breakdown report
    • get driver event performance report
    • Update custom report
    • get custom reports by user email
    • get custom report by report id
    • put subscribe to a report
    • get report subscriptions
    • get list of standard reports
    • get speeding summary report
    • get speeding breakdown report
    • get idling summary report
    • get idling breakdown report
    • Create custom report for user
  • Partner Portal
    • get full list of devices per partner
    • get full list of companies per partner
    • get user custom presets
    • create custom presets
    • update custom preset
    • delete custom preset by name
  • Releases
    • get last release
    • view a release
  • Remote Device Management
    • get config values from device
    • verify of device token
    • get current firmware of devices
    • SD-card formatting
    • get config file for device
  • Statistics
    • get statistics feature usage
  • User
    • Get Company Users
    • Get User Info from Email Address
    • Update a User's Info
    • remove a user
    • Get my Own User Info
    • Create a User
    • Get Users by Company ID
    • get user settings
    • set user settings
    • Get application notifications
    • remove the notification
    • mark notifications as viewed
    • verify password
    • SD card reformat reminder
    • Update notification by email
    • assign user to company
    • get permissions by a user_id
    • Get event / sms notification settings
  • 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
    • Delete Webhook Subscription
  1. Event

Get Device Events for Period

GET
/devices/{device_id}/events
View all the events of a device in a specific time period.

Request

Path Params
device_id
string 
required
ID of device to retrieve events
Query Params
start_ts
string 
required
Start time for event request.
Example:
YYYYMMDDhhmmss
end_ts
string 
optional
End time for event request. If not included, will default to current date and time.
Example:
YYYYMMDDhhmmss
page_number
string 
optional
Page number of response for pagination
page_size
string 
optional
Number of records returned in response for pagination
filter_type
string 
optional
Inclusive filter of comma-separated list for event types to return in response
filter_exclude_type
string 
optional
Exclusive filter of comma-separated list for event types to exclude from response
order
string 
optional
Event object param to order the response data by.
direction
string 
optional
asc/desc
include_data
enum<string> 
optional
Additional data to include into response. Select one from allowed values
Allowed value:
custom_snapshots
Example:
custom_snapshots

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/devices//events?start_ts=&end_ts=&page_number=&page_size=&filter_type=&filter_exclude_type=&order=&direction=&include_data'

Responses

🟢200200
application/json
Body
meta
object 
required
code
integer 
required
response
object 
required
events
$ref(#/definitions/2737675)[]
required
Could not resolve '#/definitions/2737675'
total_number
integer 
required
result
string 
required
Examples
{
    "meta": {
        "code": 200
    },
    "response": {
        "events": [
            {
                "accurate_duration": null,
                "archive": 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",
                "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,
                "request_ts": 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,
                "archive": 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",
                "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,
                "request_ts": 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"
}
🟠400400 (incorrect device id)
🟠404404 (device doesn't exist)
🟠400400 (incorrect type_filter)
🟠400400 (incorrect order))
🟠400400 (incorrect direction)
🟠401Login Required
Modified at 2025-07-17 17:06:43
Previous
get snapshot/location of event
Next
Request custom video from device
Built with