1. Remote Device Management
RoscoLive API v1.0
  • Authentication
    • Login
      POST
    • Logout
      GET
    • mark eula as viewed
      POST
    • password change
      POST
    • password reset
      POST
  • Company
    • Get Camera Health Errors for Company
      GET
    • Create a company
      PUT
    • get partner settings
      GET
    • Get audit logs of a company
      GET
    • get input sensors notifications of a company
      GET
    • get ignition notifications of a company
      GET
    • Get a company by ID
      GET
    • update a company by ID
      POST
    • Update company
      POST
    • search companies
      GET
    • Get companies list
      GET
    • Get a company
      GET
    • Get companies
      GET
    • get partner companies list
      GET
    • Get own partner company
      GET
    • Get profile update devices states
      GET
    • Get profile update devices
      GET
    • Export profile updates progress
      GET
    • Create zone
      PUT
    • Update zone
      POST
    • Delete zone
      DELETE
    • Get zones for company
      GET
    • Get zone movements
      GET
    • Get zone movements by vehicle
      GET
  • Custom Role Permissions
    • get full list of available custom user permission
  • Device
    • Get reported DTCs for devices
    • Get pre-selected devices
    • Store pre-selected devices
    • Migrate devices to another company
    • Get all device migrations for a company
    • Cancel device migrations for a company
    • Get company devices
    • Search devices
    • Update a device settings
    • get a device data usage
    • Play in-cab audible alert sound for device
    • get devices data usage
    • get a company devices by company ID
    • restart a device
    • Get company devices with modems
    • get distance
    • get installed report of a device
    • get an installed report
    • merge profile with device config
    • get audit logs of a device
    • Get list of trip dates for device
    • Get list of trips for passed device and date
    • Get a device
    • Get list of company devices
    • Get device with driver ID
    • create devices (legacy/DV4)
    • Create devices (auto-prov/DV4/DV6/DV7)
    • get company device using IMEI/SN
    • check red bubble in manage vehicles
    • Bulk device creation
    • Get devices for all companies available for user
    • get list of trip related snapshots
    • reset status of sd card
    • get list of all available dates
    • Get available video list for date
    • Replace device
    • get replace history by device id
    • clear device channel status
    • get camera health error by device id
    • get camera health definitions
    • update camera health error by error id
    • update camera health errors
    • Get device list for multiple companies
    • Get current activity status of devices
  • Device Firmware
    • get available firmware versions
    • get list of latest firmware versions
    • push firmware to device
    • cancel pending firmware update to devices
    • get firmware updates history for company
  • Driver Scoring / Coaching
    • Get driver scans
    • Get company drivers list
    • get a list of trips
    • associate a driver with a trip
    • get driver by event_id
    • Update a driver
    • get driver by trip_photo_id
    • Get driver scores
    • add driver photo
    • Add new driver to company
    • remove a driver
    • upload a driver from csv file
    • Get unknown driver trips
    • associate trip with the driver.
    • Get company event score weights
    • Update company event score weights
    • Get drivers coaching events
  • Event
    • Request Custom Snapshots for Time Range
    • Request Custom 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
    • Send an event
    • get status of an event
    • Request videos of an event
    • Get Uploaded Event Videos
    • get events summary of devices
    • get events summary of a device
    • get a company events by company ID
    • get status of an event by company ID
    • Get Event Snapshots
    • get snapshots of an event or alert by company ID
    • Get a last device event
    • Get Latest Event for Each Device in Company
    • get events log of a device
    • get dates of events
    • get events for charts and graphs
    • get events for charts and graphs by company ID
    • get an event by company ID
    • get events summary of a device by company ID
    • request videos of an event by company ID
    • get dates of an events by company ID
    • get a last event of company device
    • clear last event
    • get dates of events of a device
    • Update Custom Event
    • delete an event
    • request videos of an alert
    • Share an event
    • Get an event by a permalink
    • get geotab events
    • Get a last updated event of devices
    • download a blocked event
    • Get Flagged Company Events
    • flag an event
    • unflag an event
    • generate snapshots
    • local geocoding service
    • update an event
    • Get snapshot/location of event
    • Get Device Events for Period
    • Request custom video from device
    • get snapshot on demand
    • Get an event by a permalink hash
    • Set Event Label for Event
    • Restore event video from archive
    • Add users for notification of event restore from archive
    • Add event label
    • Add user feedback to event
    • Get event user feedback
    • Get event filters list for date range in company
    • 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
    • Get an external service account
    • Pair RL device with external device
    • Get RL device data via external device unique serial number
    • external service login
    • get a device
  • 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
  • Group
    • get company groups
    • add a group
    • remove a group
    • get devices of a group
    • add a device to a group
    • remove a device from a group
    • get users of a group
    • add a user to a group
    • remove a user from a group
    • get company groups by company ID
    • add a device to a group by company ID
    • Get devices of a group
    • remove a device from a group by company ID
    • remove a group by company ID
    • add a group by company ID
    • add an user to a group by company ID
    • get users of a group by company ID
    • remove an user from a group by company ID
    • edit group
    • get groups with ID
    • get group of a company by group ID
  • Live streaming
    • start live streaming
    • stop live streaming
    • start multi-channel live streaming
    • stop multi-channel live streaming
  • Metadata
    • Get metadata of a device
    • Get metadata of devices
    • Get alerts and events of devices for company
    • get alerts for charts and graphs
    • Get metadata of device(s) for last 24 hours
    • Get alerts of a device
    • Get alerts of a driver
  • Modem Administration
    • get list of available modems
    • upgrade modem firmware
    • upgrade modem firmware for group of devices
  • Report
    • get data usage report
    • Get custom report data
    • get data usage report by device id
    • get list of companies with data usage for date range
    • get data usage for active devices for specified companies
    • get companies with data usage for date range
    • get data usage report for devices in company
    • get data tracking report
    • Request IFTA report of a company
    • Get IFTA report of a company
    • Get IFTA report in CSV-file by company
    • Get paired GO device report
    • get all events report
    • Get all events report for company
    • get vehicle activity report
    • get firmware report
    • Get event count summary report for company devices
    • get driver event breakdown report
    • get driver event performance report
    • Update custom report
    • get custom reports by user email
    • get custom report by report id
    • put subscribe to a report
    • get report subscriptions
    • get list of standard reports
    • get speeding summary report
    • get speeding breakdown report
    • get idling summary report
    • get idling breakdown report
    • Create custom report for user
  • Partner Portal
    • get full list of devices per partner
    • get full list of companies per partner
    • get user custom presets
    • create custom presets
    • update custom preset
    • delete custom preset by name
  • Releases
    • get last release
    • view a release
  • Remote Device Management
    • Get device config history
      GET
    • Get device config history file
      GET
    • get config values from device
      GET
    • verify of device token
      GET
    • get current firmware of devices
      GET
    • SD-card formatting
      POST
    • get config file for device
      GET
  • Statistics
    • get statistics feature usage
  • User
    • Record map type usage
    • Get Company Users
    • Get User Info from Email Address
    • Update a User's Info
    • remove a user
    • Get my Own User Info
    • Create a User
    • Get Users by Company ID
    • get user settings
    • set user settings
    • Get application notifications
    • remove the notification
    • mark notifications as viewed
    • verify password
    • SD card reformat reminder
    • Update notification by email
    • assign user to company
    • get permissions by a user_id
    • Get event / sms notification settings
  • 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
    • Delete Webhook Subscription
  • Asset
    • Create asset
    • Update asset
    • Delete asset
    • Get assets for company
    • Pair asset to device
    • Unpair asset from device
    • Get asset history
  • Schemas
    • Authentication
      • Login Response
    • Device
      • Sub-schemas
        • Channel Status
        • Latest HDD Error
        • Firmware Version
        • Ignition Status
        • Livestream Status
        • Modem Status
        • GPS Schema
        • Pending device config options
        • Metadata
        • Single error status
        • Grouped error status
        • Storage Wear
      • Company Device List
      • Device
      • Live Stream - Start
      • Multi Live Stream - Start
      • Device error
      • Pre-selected devices
    • Company
      • Sub-schemas
        • Data usage
      • Company
      • Partner
    • Events
      • Alerts schema
      • Event schema
    • User
      • Sub-schemas
        • Show Notifications
      • User schema
    • Webhook
      • Notification Payloads
      • Development Prototypes
        • Alert Notification
        • Webhook Parent Notification
        • Webhook Subscription
      • Notification Settings
    • Profiles
      • Profile
      • Profile history
    • Reports
      • Sub-schemas
        • Filters Schema
        • IFTA Report Item
      • Custom Report
      • IFTA Report
    • External Service
      • External device data
        • Webfleet device data
        • Ituran device data
      • BeWhere
        • BeWhere tracker data
        • BeWhere tracker metadata
      • External service account
      • External service device data
  1. Remote Device Management

Get device config history file

Tested
GET
/devices/config_history/{config_history_id}/file

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

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/devices/config_history//file'

Responses

🟢200Success
text/plain
Example
Channels.0.Audio=0
Channels.0.Enabled=true
Channels.0.MainFPS=24
Channels.0.MainQuality=2
Channels.0.ParkingFPS=1
Channels.0.ParkingQuality=1
Channels.0.Record=1
Channels.0.Substream=true
Channels.0.index=0
Channels.1.Audio=1
Channels.1.Enabled=true
Channels.1.MainFPS=24
Channels.1.MainQuality=2
Channels.1.ParkingFPS=1
Channels.1.ParkingQuality=1
Channels.1.Record=1
Channels.1.Substream=true
Channels.1.index=1
Channels.2.Audio=0
Channels.2.Enabled=false
Channels.2.MainFPS=24
Channels.2.MainQuality=2
Channels.2.ParkingFPS=1
Channels.2.ParkingQuality=1
Channels.2.Record=0
Channels.2.Substream=false
Channels.2.index=2
Channels.3.Audio=0
Channels.3.Enabled=false
Channels.3.MainFPS=24
Channels.3.MainQuality=2
Channels.3.ParkingFPS=1
Channels.3.ParkingQuality=1
Channels.3.Record=0
Channels.3.Substream=false
Channels.3.index=3
Debug.Activated=""2026-02-10 12:03:25""
Debug.LcdDisplayMode=0
Debug.Updated=""2026-04-13 14:16:19""
Debug.UseLegacyLive=false
Event.Accelerometer.Enable.X=true
Event.Accelerometer.Enable.Y=true
Event.Accelerometer.Enable.Z=false
Event.Accelerometer.Enabled=true
Event.Accelerometer.FatalSendToCloud=true
Event.Accelerometer.FatalThreshold.X=1.2
Event.Accelerometer.FatalThreshold.Y=1.2
Event.Accelerometer.FatalThreshold.Z=2
Event.Accelerometer.FatalTriggerOutput=-1
Event.Accelerometer.ParkingThreshold.X=0.2
Event.Accelerometer.ParkingThreshold.Y=0.2
Event.Accelerometer.ParkingThreshold.Z=1.2
Event.Accelerometer.SendToCloud=false
Event.Accelerometer.Threshold.X=10
Event.Accelerometer.Threshold.Y=10
Event.Accelerometer.Threshold.Z=10
Event.Accelerometer.TriggerOutput=-1
Event.Adas.CameraHeight=150
Event.Adas.CameraOffset=0
Event.Adas.Enabled=false
Event.Adas.FollowingDistance.Enabled=false
Event.Adas.FollowingDistance.SendToCloud=false
Event.Adas.FollowingDistance.Sensitivity=0
Event.Adas.FollowingDistance.SpeedThreshold=32
Event.Adas.FollowingDistance.SpeedUnit=""mph""
Event.Adas.FollowingDistance.Ttc.TriggerThreshold=0.6
Event.Adas.ForwardCollision.Enabled=false
Event.Adas.ForwardCollision.SendToCloud=false
Event.Adas.ForwardCollision.Sensitivity=0
Event.Adas.FrontVehicleStart.Enabled=false
Event.Adas.FrontVehicleStart.Sensitivity=0
Event.Adas.Headway.Enabled=false
Event.Adas.Headway.SendToCloud=false
Event.Adas.Headway.Sensitivity=0
Event.Adas.Headway.SpeedThreshold=32
Event.Adas.Headway.SpeedUnit=""mph""
Event.Adas.Headway.Ttc.TriggerThreshold=0.6
Event.Adas.LaneDeparture.Enabled=false
Event.Adas.LaneDeparture.SendToCloud=false
Event.Adas.Pedestrian.Enabled=false
Event.Adas.Pedestrian.SendToCloud=false
Event.Adas.SpeedThreshold=0
Event.Adas.StopSignViolation.Enabled=false
Event.Adas.StopSignViolation.Sensitivity=0
Event.Adas.StopSignViolation.SpeedThreshold=8.07
Event.Adas.TrafficLightViolation.Enabled=false
Event.Adas.TrafficLightViolation.Sensitivity=0
Event.Adas.TrafficLightViolation.SpeedThreshold=16.11
Event.Adas.VehicleHoodLength=0
Event.Adas.VehicleWidth=170
Event.BackUpWarning.Enabled=false
Event.BlindSpotWarning.Standard.Enabled=false
Event.BlindSpotWarning.Standard.SpeedThreshold=25.75
Event.BlindSpotWarning.Urban.Enabled=false
Event.BlindSpotWarning.Urban.SpeedThreshold=0
Event.BuzzerEnabled=false
Event.Dms.CameraObstruction.Enabled=false
Event.Dms.Distraction.Enabled=true
Event.Dms.Distraction.SendToCloud=true
Event.Dms.Distraction.Sensitivity=0
Event.Dms.Dozing.Enabled=true
Event.Dms.Dozing.SendToCloud=true
Event.Dms.Dozing.Sensitivity=0
Event.Dms.Enabled=true
Event.Dms.HeadDown.Enabled=true
Event.Dms.HeadDown.SendToCloud=true
Event.Dms.HeadDown.Sensitivity=0
Event.Dms.PhoneUse.Enabled=true
Event.Dms.PhoneUse.SendToCloud=true
Event.Dms.PhoneUse.Sensitivity=0
Event.Dms.Seatbelt.Enabled=false
Event.Dms.Seatbelt.SendToCloud=false
Event.Dms.Seatbelt.Sensitivity=0
Event.Dms.Sensitivity=1
Event.Dms.Smoking.Enabled=false
Event.Dms.Smoking.Sensitivity=0
Event.Dms.Yawning.Enabled=true
Event.Dms.Yawning.SendToCloud=true
Event.Dms.Yawning.Sensitivity=0
Event.GSensorWakeUp.Enabled=false
Event.GSensorWakeUp.Sensitivity=0
Event.HarshAccel.Enabled=true
Event.HarshAccel.SendToCloud=true
Event.HarshAccel.Threshold=9.5
Event.HarshBraking.Enabled=true
Event.HarshBraking.SendToCloud=true
Event.HarshBraking.Threshold=11
Event.HighSpeed.Enabled=false
Event.HighSpeed.SendToCloud=false
Event.HighSpeed.Threshold=112.65
Event.HighSpeed.TriggerOutput=-1
Event.HighTemperature.Enabled=true
Event.HighTemperature.ShutdownDelay=150
Event.HighTemperature.Threshold=99
Event.PanicButton.Enabled=true
Event.Sensor.0.ActiveHigh=true
Event.Sensor.0.Enabled=false
Event.Sensor.0.Name=""Sensor #1""
Event.Sensor.0.SendToCloud=false
Event.Sensor.0.ShortName=""S1""
Event.Sensor.0.TriggerOutput=-1
Event.Sensor.0.index=0
Event.Sensor.1.ActiveHigh=true
Event.Sensor.1.Enabled=false
Event.Sensor.1.Name=""Sensor #2""
Event.Sensor.1.SendToCloud=false
Event.Sensor.1.ShortName=""S2""
Event.Sensor.1.TriggerOutput=-1
Event.Sensor.1.index=1
Event.Sensor.2.ActiveHigh=true
Event.Sensor.2.Enabled=false
Event.Sensor.2.Name=""Sensor #3""
Event.Sensor.2.SendToCloud=false
Event.Sensor.2.ShortName=""S3""
Event.Sensor.2.TriggerOutput=-1
Event.Sensor.2.index=2
Event.Sensor.3.ActiveHigh=true
Event.Sensor.3.Enabled=false
Event.Sensor.3.Name=""Sensor #4""
Event.Sensor.3.SendToCloud=false
Event.Sensor.3.ShortName=""S4""
Event.Sensor.3.TriggerOutput=-1
Event.Sensor.3.index=3
Event.Sensor.4.Enabled=true
Event.Sensor.4.Name=""External Driver Event""
Event.Sensor.4.SendToCloud=true
Event.Sensor.4.ShortName=""EE""
Event.Sensor.4.TriggerOutput=-1
Event.Sensor.4.index=4
Event.Sensor.5.SendToCloud=true
Event.Sensor.5.TriggerOutput=-1
Event.Sensor.5.index=8
Event.Sensor.8.SendToCloud=true
Event.Sensor.8.TriggerOutput=-1
Event.Sensor.8.index=8
Event.SpeedLimitViolation.High.Enabled=false
Event.SpeedLimitViolation.Low.Enabled=false
Event.SpeedLimitViolation.Moderate.Enabled=false
Event.SpeedLimitViolation.Severe.Enabled=false
Event.SpeedLimitViolation.SpeedThreshold=0
Event.Voltage.Enabled=true
Event.Voltage.HighThreshold=32
Event.Voltage.LowThreshold=11.5
Event.Voltage.RecoveryThreshold=12
Event.Voltage.ShutdownDelay=20
General.IgnitionShutdownDelay=60
General.IgnitionSwitchOnly=true
General.TimeZone=""US/Eastern""
IdInfo.DriverId=""0""
IdInfo.DriverName=""""
IdInfo.DvrName=""DVT00021 TT""
IdInfo.FleetProfile=""Manual""
IdInfo.FleetProfileId=0
Network.Mobile.Enabled=false
Network.Wifi.Configs.0.Password=""sprava2019""
Network.Wifi.Configs.0.SSID=""sprava2""
Network.Wifi.Enabled=true
Overlay.ShowSpeed=true
Overlay.ShowTZ=false
Peripherals.CanBus.Type=0
Peripherals.CardReader.Enabled=true
Peripherals.Dms.Enabled=false
Peripherals.Mobileye.Enabled=false
Recording.LockEventFiles=false
Servers.Ads.DisableRecording=false
Servers.Ads.EnableAutoUpgrade=true
Servers.Ads.Enabled=false
Servers.Ads.ShutdownDelay=480
Servers.CloudAds.Enabled=true
Servers.CloudAds.FleetToken=77987163
Servers.CloudAds.Host=""stagingdirect.roscolive.com""
Servers.CloudAds.Port=5601
Servers.CloudAds.SendLocalEvents=true
Servers.LiveVideo.Enabled=true
Servers.RoscoLive.AlarmReportInterval=5
Servers.RoscoLive.AssetId=4867343666
Servers.RoscoLive.Enabled=true
Servers.RoscoLive.ReportInterval=5
Servers.SleepMode.Enabled=false
Servers.SleepMode.Host=""stagingdirect.roscolive.com""
System.BacklightHigh=400
System.BacklightLow=202
System.Chimes.Accelerometer=false
System.Chimes.Adas=false
System.Chimes.BackUpWarning=2
System.Chimes.BlindSpotWarning.Standard=2
System.Chimes.BlindSpotWarning.Urban=2
System.Chimes.CameraObstruction.Enabled=0
System.Chimes.CameraObstruction.SoundType=0
System.Chimes.Distraction=1
System.Chimes.Dms=false
System.Chimes.Drowsiness=true
System.Chimes.FollowingDistance=1
System.Chimes.ForwardCollision=true
System.Chimes.FrontVehicleStart=2
System.Chimes.GSensorWakeUp=0
System.Chimes.HarshAccel=0
System.Chimes.HarshBraking=0
System.Chimes.Headway=1
System.Chimes.HighSpeed=0
System.Chimes.LaneDeparture=true
System.Chimes.PhoneUse=true
System.Chimes.PowerOn=1
System.Chimes.Seatbelt=0
System.Chimes.Smoking=false
System.Chimes.SpeedLimitViolation.High=1
System.Chimes.SpeedLimitViolation.Low=2
System.Chimes.SpeedLimitViolation.Moderate=1
System.Chimes.SpeedLimitViolation.Severe=1
System.Chimes.StopSignViolation=0
System.Chimes.TrafficLightViolation=0
System.Chimes.Volume=100
System.Chimes.Yawning=true
System.DisplaySpeed=true
System.SpeedUnit=1
🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Modified at 2026-06-22 14:27:34
Previous
Get device config history
Next
get config values from device
Built with