1. Device
RoscoLive API v1.0(v2.41.0)
  • Authentication
    • Login
      POST
    • Logout
      GET
  • Report
    • Get custom report data
      GET
    • Get paired GO device report
      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 a company by ID
      GET
    • Update company
      POST
    • Get a company
      GET
    • Get companies
      GET
    • Get own partner company
      GET
  • Remote Device Management
    • Get device config history
      GET
    • Get device config history file
      GET
  • Device
    • Search devices
      GET
    • Update a device settings
      POST
    • Get a device
      GET
    • Get list of company devices
      GET
    • Get device with driver ID
      GET
    • Create devices (auto-prov/DV4/DV6/DV7)
      PUT
    • Get devices for all companies available for user
      GET
    • Get device list for multiple companies
      GET
    • Get current activity status of devices
      GET
  • Driver Scoring / Coaching
    • Get company event score weights
    • Update company event score weights
  • Event
    • Get Company Events
    • Get Latest Event for Each Device in Company
    • Share an event
    • Get a last updated event of devices
    • Get list of company events
  • External Service
    • BeWhere
      • Get BeWhere trackers by group
      • Add BeWhere tracker to group
      • Remove BeWhere tracker from group
      • Get list of BeWhere trackers for a company
      • Get available dates for a BeWhere tracker
      • Get metadata for a BeWhere tracker
  • Group
    • Get devices of a group
  • Metadata
    • Get alerts and events of devices for company
    • Get alerts of a device
  • Webhooks
    • Add Webhook Subscription to Multiple Event Types
    • Get Notification Subscriptions for Event Type
    • Set Notifications for Event Type
    • Remove Notification Subscription for Event Type
    • Get All Webhook Subscriptions for a Company
  • Installer App
    • Get user installed devices
  1. Device

Get device with driver ID

GET
/driver/devices/cardreader
Get device with driver_id.

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

Query Params

Responses

🟢200Valid get device with driver ID
application/json
Bodyapplication/json

🟠404Get device with driver ID with non existing company_id
🟠401Login Required
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/driver/devices/cardreader?company_id=undefined'
Response Response Example
200 - Valid get device with driver ID
{
    "meta": {
        "code": 200
    },
    "response": {
        "devices": [
            {
                "activated_timestamp": "2022-08-03 17:50:56",
                "active": true,
                "adas_camera_height": 150.0,
                "adas_camera_offset": 0.0,
                "adas_units": "imperial",
                "adas_vehicle_hood_len": 150.0,
                "adas_vehicle_width": 170.0,
                "asset_id": 4240,
                "canbus": "0",
                "channel_available": "1,2",
                "company_id": "66",
                "company_name": "TransfoTech",
                "config_checksum": 1,
                "data_limit": 0,
                "device_id": "98293836",
                "device_type": "dv4",
                "disable_live_stream": false,
                "general_status": "offline",
                "gps_online": false,
                "group_name": "UI test group",
                "incorrect_device_time": false,
                "installed_id": 1116,
                "last_connected_ts": "2025-02-27 15:32:25",
                "last_disconnected_ts": "2025-02-27 15:34:41",
                "last_sleep_connected_ts": null,
                "last_sleep_disconnected_ts": null,
                "online": false,
                "pending_company_profile": "api_tests543",
                "serial_number": "XC4RECO123456701",
                "sleep": 0,
                "tag_plate": "001234SC",
                "timezone": "US/Eastern",
                "uploaded_company_profile": "default (old)",
                "vehicle_icon": "van",
                "vehicle_name": "OfflineMainDeviceForApi",
                "vin_number": "11112222333344"
            }
        ]
    },
    "result": "OK"
}
Modified at 2026-06-23 16:46:13
Previous
Get list of company devices
Next
Create devices (auto-prov/DV4/DV6/DV7)
Built with