RoscoLive API v1.0(v2.37.0)
  1. Metadata
RoscoLive API v1.0(v2.37.0)
  • Company
    • Create a company
      PUT
    • Get a company by ID
      GET
    • Update company
      POST
    • Get a company
      GET
    • Get companies
      GET
  • Device
    • Geotab
      • Get device by geotab device serial number
    • Update a device settings
      POST
    • Get reported DTCs for devices
      GET
    • Get company devices
      GET
    • Search devices
      GET
    • Play in-cab audible alert sound for device
      POST
    • Get list of trip dates for device
      GET
    • Get list of trips for passed device and date
      GET
    • Get a device
      GET
    • Get devices for all companies available for user
      GET
    • Get available video list for date
      GET
    • Get device list for multiple companies
      GET
  • Driver Scoring / Coaching
    • Get driver scores
      GET
    • Get unknown driver trips
      GET
  • Event
    • Request Custom Event
      PUT
    • Get Company Events
      GET
    • Send an event
      PUT
    • Get snapshot/location of event
      GET
    • Get Device Events for Period
      GET
    • Request custom video from device
      PUT
    • Get event filters list for date range in company
      GET
  • Group
    • Get devices of a group
  • Metadata
    • Get metadata of a device
      GET
    • Get metadata of devices
      GET
    • Get alerts of a driver
      GET
  1. Metadata

Get alerts of a driver

GET
/driver/{driver_id}/alerts
Get alerts of a driver.
Type of 'event_types' can be executed by one or several following parameters: 'gsensor', 'speed', 'critical_gsensor','driver', 'sensor', 'pending', 'custom', 'ADAS-PCW', 'ADAS-FCW', 'ADAS-LCW', 'ADAS-HW'. 'alert_types' parameter can have one or several values separated by ',': 'SD Card Failure', 'Improper Shutdown', 'Camera Failure'

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

🟢200Success
application/json
Body

🟠400Invalid datetime format
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/driver/1415/alerts?start_ts=20250801000000&end_ts=20250819235959&alert_types={{OPTIONAL: alert_types}}&event_types={{OPTIONAL: event_types}}&page_number={{OPTIONAL: page_number}}&page_size={{OPTIONAL: page_size}}&no_alarms={{OPTIONAL: no_alarms}}'
Response Response Example
200 - Example 1
{
    "meta": {
        "code": 200
    },
    "response": [
        {
            "alarms": [
                {
                    "asset_id": null,
                    "event_id": null,
                    "id": 160686,
                    "timestamp": "2025-10-15 17:38:41",
                    "type": "Distraction"
                },
                {
                    "asset_id": null,
                    "event_id": null,
                    "id": 160360,
                    "timestamp": "2025-10-09 18:21:17",
                    "type": "Max Speed"
                }
            ],
            "asset_id": 123,
            "device_id": 4914264277,
            "driver_id": 71,
            "driver_name": "Mark Lewis",
            "events": [
                {
                    "asset_id": null,
                    "event_type": "Sensor",
                    "id": 1908402,
                    "timestamp": "2025-10-11 18:37:10"
                }
            ],
            "vehicle_name": "Truck A"
        },
        {
            "alarms": [
                {
                    "asset_id": null,
                    "event_id": null,
                    "id": 161079,
                    "timestamp": "2025-10-22 18:41:19",
                    "type": "UncleanShutdown"
                }
            ],
            "asset_id": 321,
            "device_id": 2782942955,
            "driver_id": 71,
            "driver_name": "Paul Grant",
            "events": [
                {
                    "asset_id": null,
                    "event_type": "Sensor",
                    "id": 1908649,
                    "timestamp": "2025-10-23 17:05:37"
                }
            ],
            "vehicle_name": "Truck B"
        }
    ],
    "result": "OK"
}
Modified at 2025-10-26 15:45:11
Previous
Get metadata of devices
Built with