1. Device
RoscoLive API v1.0(v2.40.0)
  • Report
    • Get custom report data
      GET
    • Get all events report for company
      GET
    • Get event count summary report for company devices
      GET
    • Update custom report
      POST
    • Create custom report for user
      PUT
  • Company
    • private
      • Create a new partner company
      • Update partner company info
      • Get a partner company
      • Disable a customer company
      • Enable a customer company
      • Disable a partner company
      • Enable a partner company
    • Create a company
      PUT
    • Get audit logs of a company
      GET
    • Get a company by ID
      GET
    • Update company
      POST
    • Get companies list
      GET
    • Get a company
      GET
    • Get companies
      GET
    • Get own partner company
      GET
  • User
    • Get Company Users
      GET
    • Get User Info from Email Address
      GET
    • Update a User's Info
      POST
    • Get my Own User Info
      GET
    • Create a User
      PUT
    • Update notification by email
      POST
  • Device
    • Update a device settings
      POST
    • Get company devices with modems
      GET
    • Get a device
      GET
    • Create devices (auto-prov/DV4/DV6/DV7)
      PUT
  • Driver Scoring / Coaching
    • Get company drivers list
      GET
    • Get driver scores
      GET
    • Add new driver to company
      PUT
    • Get company event score weights
      GET
    • Update company event score weights
      POST
  • Event
    • Get an Event of a Device by Start Time
    • Get an Event by ID and Storage Type
    • Get Company Events
    • Get Event by Company and ID
    • Get Flagged Company Events
    • Get Device Events for Period
    • Get list of company events
  • Metadata
    • Get alerts and events of devices for company
    • Get alerts of a driver
  • Fleet Configuration
    • Get profiles of a company
    • Get company default profile settings
    • Remove a company profile
    • Create new profile in a company
    • Get a company profile
    • Get profile history
    • Update a company profile
  • DocuWiki Support
    • Rosco customer registration
  • Installer App
    • Add install report
    • Installer registration
    • Install Rosco device
  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": "proident fugiat",
            "groups": [
                "officia Excepteur",
                "dolor Ut minim dolore dolore",
                "cupidatat ad"
            ],
            "ignition_switch_only": true,
            "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_name": null,
            "vin_number": "in Excepteur eiusmod dolor",
            "windshield_img": 1
        }
    },
    "result": "OK"
}
Modified at 2026-06-23 16:46:13
Previous
Get company devices with modems
Next
Create devices (auto-prov/DV4/DV6/DV7)
Built with