RoscoLive API v1.0
  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 a driver
      PUT
  • Event
    • Get company events
      GET
    • Request videos of an event
      PUT
    • get a last event of devices
      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 a last event of devices

GET
/partners/companies/{company_name}/devices/lastevent
deviceeventlist
Returns a list of latest events from devices in the company passed into the request.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/partners/companies//devices/lastevent?inactive=false'
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": {
        "devices": [
            {
                "device_id": "12345",
                "driver_id": 12345,
                "driver_name": "Thomas Hudson",
                "events": [
                    {
                        "endtime": "2022-10-18T18:47:19.0Z",
                        "id": "1909786",
                        "name": "InputSensor9",
                        "starttime": "2022-10-18T18:47:09.0Z"
                    },
                    {
                        "endtime": "2022-10-18T18:47:19.0Z",
                        "id": "1909786",
                        "name": "InputSensor9",
                        "starttime": "2022-10-18T18:47:09.0Z"
                    }
                ],
                "general_status": "pending_awake",
                "gps": {
                    "dir": "84",
                    "dst": "2756",
                    "key": true,
                    "lan": "40.70168685913086",
                    "lon": "-73.81008148193359",
                    "spd": "40",
                    "timestamp": "2024-01-01T17:32:41.0Z"
                },
                "ignition": {
                    "state": true,
                    "ts": "2024-05-04T23:57:01.0Z"
                },
                "modem_rssi": "-51",
                "online": false,
                "sleep": 2,
                "vehicle_name": "Truck 1"
            },
            {
                "device_id": "12345",
                "driver_id": 12345,
                "driver_name": "Mrs. Monique Aufderhar DVM",
                "events": [
                    {
                        "endtime": "2022-10-18T18:47:19.0Z",
                        "id": "1909786",
                        "name": "InputSensor9",
                        "starttime": "2022-10-18T18:47:09.0Z"
                    },
                    {
                        "endtime": "2022-10-18T18:47:19.0Z",
                        "id": "1909786",
                        "name": "InputSensor9",
                        "starttime": "2022-10-18T18:47:09.0Z"
                    }
                ],
                "general_status": "offline",
                "gps": {
                    "dir": "84",
                    "dst": "2756",
                    "key": false,
                    "lan": "40.70168685913086",
                    "lon": "-73.81008148193359",
                    "spd": "40",
                    "timestamp": "2024-01-01T17:32:41.0Z"
                },
                "ignition": {
                    "state": true,
                    "ts": "2024-05-04T23:57:01.0Z"
                },
                "modem_rssi": "-51",
                "online": false,
                "sleep": 2,
                "vehicle_name": "Truck 1"
            },
            {
                "device_id": "12345",
                "driver_id": 12345,
                "driver_name": "Robin Welch MD",
                "events": [
                    {
                        "endtime": "2022-10-18T18:47:19.0Z",
                        "id": "1909786",
                        "name": "InputSensor9",
                        "starttime": "2022-10-18T18:47:09.0Z"
                    }
                ],
                "general_status": "awake",
                "gps": {
                    "dir": "84",
                    "dst": "2756",
                    "key": false,
                    "lan": "40.70168685913086",
                    "lon": "-73.81008148193359",
                    "spd": "40",
                    "timestamp": "2024-01-01T17:32:41.0Z"
                },
                "ignition": {
                    "state": true,
                    "ts": "2024-05-04T23:57:01.0Z"
                },
                "modem_rssi": "-51",
                "online": true,
                "sleep": 2,
                "vehicle_name": "Truck 1"
            }
        ]
    },
    "result": "OK"
}

Request

Path Params
company_name
string 
required
Company name in RoscoLive
Query Params
inactive
boolean 
optional
A flag for including inactive devices in the response if set to true
Example:
false

Responses

🟢200Success
application/json
Body
meta
object 
required
Request metadata object
code
integer 
required
HTTP status code returned by server
response
object 
required
Contains response data
devices
array [object {11}] 
required
List of devices for the passed in Company Name
result
string 
required
"OK" if request successful, otherwise "Fail"
🟠401Login Required
Modified at 2025-06-15 10:46:58
Previous
Request videos of an event
Next
get geotab events
Built with