1. Device
RoscoLive API v1.0(v2.42.0)
  • Authentication
    • Login
      POST
    • Logout
      GET
  • Report
    • Request IFTA report of a company
      POST
    • Get IFTA report of a company
      GET
    • Get IFTA report in CSV-file by company
      GET
    • Update a report's subscription options
      POST
    • Put subscribe to a report
      PUT
    • Get report subscriptions
      GET
  • Company
    • Add custom user profile
      PUT
    • Get custom user profiles
      GET
  • User
    • Get User Info from Email Address
      GET
    • Update notification by email
      POST
  • Device
    • Get stop routes of devices
      GET
    • Update a device settings
      POST
    • Get a device
      GET
    • Get list of company devices
      GET
    • Get devices for all companies available for user
      GET
    • Get device list for multiple companies
      GET
  • Driver Scoring / Coaching
    • Upload a driver from csv file
      PUT
  • Event
    • Get list of company events
      GET
  • Metadata
    • Get missing GPS intervals of devices
      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 '/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-06-23 16:52:32
Previous
Update a device settings
Next
Get list of company devices
Built with