1. Device
RoscoLive API v1.0
  • Device
    • Get a device
      GET
  • Driver Scoring / Coaching
    • Get drivers coaching events
      GET
  • Event
    • Get Company Events
      GET
    • Get Flagged Company Events
      GET
    • Request custom video from device
      PUT
    • 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
  1. Device

Get a device

GET
/partners/devices/{device_id}
Get information for device device_id.
Additional data can be added to the response by including one of the geotab and modem flags.

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

Cookie Params

Responses

🟢200Valid get a device
application/json
Bodyapplication/json

🟠400Get a device with incorrect device_id
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/partners/devices/?include_data=&geotab=&modem=&partner_device=undefined' \
--header 'Cookie: session={{session}};session_token={{session_token}}'
Response Response Example
200 - Success
{
    "meta": {
        "code": 200
    },
    "response": {
        "device": {
            "activated_timestamp": "2024-01-01 17:31:42",
            "active": false,
            "ads_online": false,
            "antenna_img": 1,
            "can_log_upload": true,
            "canbus": "0",
            "cardreader": true,
            "channel_available": "fugiat eu dolore aliquip sint",
            "channel_status": [
                {
                    "channel": 1,
                    "check_type": "last_event",
                    "fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/3533774732/2636399/1.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=9nU0EhsvVUJO50XuLo90UqoBsF0%3D&Expires=1765037071",
                    "fail_status": "black",
                    "fail_ts": "2025-10-27 16:35:50",
                    "misalignment": true,
                    "success_ts": "2025-10-28 11:30:00"
                },
                {
                    "channel": 2,
                    "check_type": "last_event",
                    "fail_snapshot_link": "https://stages3.roscocloud.com/rosco-user-825/3533774732/2636399/2.jpeg?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=mWdhMw5FcT37mcsE%2BOGlTkcvdM0%3D&Expires=1765037071",
                    "fail_status": "black",
                    "fail_ts": "2025-10-27 16:35:50",
                    "success_ts": "2025-10-28 11:30:00"
                }
            ],
            "company_id": 12345,
            "company_name": "Carroll - Runolfsdottir",
            "config_checksum": 43447898,
            "created_at": "2024-01-01 17:31:42",
            "data_limit": 1,
            "deleted_at": "2024-01-01T17:31:42.0Z",
            "device_id": "12345",
            "device_type": "dv6",
            "disable_live_stream": false,
            "dms_enabled": true,
            "driver_id": "6930",
            "driver_last_update": "2024-01-01 17:31:42",
            "driver_name": "Stanley Bahringer",
            "driver_recognition": null,
            "flood_blocked": 8449852,
            "general_status": "offline",
            "groups": [
                "officia Excepteur",
                "dolor Ut minim dolore dolore",
                "cupidatat ad"
            ],
            "ignition_switch_only": true,
            "incorrect_device_time": false,
            "installed_by_user_id": null,
            "installed_id": "commodo deserunt cupidatat qui",
            "is_flagged": true,
            "is_installation": false,
            "is_installation_report": false,
            "last_disconnected_ts": "2024-01-01 17:31:42",
            "last_sleep_connected_ts": "2024-01-01 17:31:42",
            "last_sleep_disconnected_ts": "2024-01-01 17:31:42",
            "live_online": true,
            "matching_token": "sed",
            "migration": false,
            "modem_img": 0,
            "onboard_capacity": 0,
            "online_gps": true,
            "parking_duration": 420,
            "partner_device": {
                "device_data": {}
            },
            "partner_name": "Pacocha - Mraz",
            "pending_config": {
                "adas_camera_height": "150",
                "adas_camera_offset": "0",
                "adas_vehicle_hood_len": "150",
                "adas_vehicle_width": "170",
                "can_log_upload": true,
                "canbus": "0",
                "cardreader": true,
                "ignition_switch_only": true,
                "parking_duration": "Ut ullamco adipisicing ipsum eu",
                "timezone": "2024-01-01 17:31:42"
            },
            "power_img": 68138184,
            "recording_status": "OK",
            "sdcard_capacity": 119190,
            "serial_number": null,
            "silence_err_notifs": "in laborum fugiat",
            "sleep_mode_enabled": true,
            "status": "used",
            "storage_wear": {
                "onboard_free_space": null,
                "onboard_wear_level": null,
                "sdcard_free_space": 12030,
                "sdcard_wear_level": 100.0
            },
            "tag_plate": null,
            "timezone": "America/Halifax",
            "uploaded_company_profile": null,
            "users": "consequat ut",
            "vehicle_icon": "van",
            "vehicle_icon_size": false,
            "vehicle_name": null,
            "vin_number": "in Excepteur eiusmod dolor",
            "windshield_img": 1
        }
    },
    "result": "OK"
}
Modified at 2026-07-07 19:28:34
Next
Get drivers coaching events
Built with