RoscoLive API v1.0
  1. Device Firmware
RoscoLive API v1.0
  • Authentication
    • Login
      POST
    • Logout
      GET
    • mark eula as viewed
      POST
    • password change
      POST
    • password reset
      POST
  • Company
    • get camera health error
      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
  • Custom Role Permissions
    • get full list of available custom user permission
      GET
  • Device
    • get company devices
    • search devices
    • update a device
    • get a device data usage
    • Play audible alert sound
    • 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/DV6)
    • 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
    • get list of latest firmware versions
      GET
    • push firmware to device
      POST
    • cancel pending firmware update to devices
      DELETE
    • get firmware updates history for company
      GET
  • Driver Scoring / Coaching
    • 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 a driver
    • 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
    • Get company events
    • get an event
    • send an event
    • get status of an event
    • Request videos of an event
    • get uploaded videos of an event
    • 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 snapshots of an event or alert
    • get snapshots of an event or alert by company ID
    • get a last event
    • get a last event of devices
    • 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
    • push 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 events for a device
    • 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
  • External Service
    • 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
    • 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 by company ID
    • 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
    • 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 config values from device
    • verify of device token
    • get current firmware of devices
    • SD-card formatting
    • get config file for device
  • Statistics
    • get statistics feature usage
  • User
    • get company users
    • Get a user
    • update a user
    • remove a user
    • Get own info
    • create a user
    • get company 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
    • get push notifications
    • set push notifications
    • remove push notifications
  1. Device Firmware

get available firmware versions

GET
/availablefirmware
firmware
Get available firmware versions. NOTE: Only Partners with valid permissions can access this endpoint.

Request

None

Request 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 --request GET 'https://fleet.roscolive.com/api/v1.0/availablefirmware'

Responses

🟢200OK
application/json
Body
meta
object 
required
Request metadata object
code
string 
required
HTTP status code returned by server
firmwares
array [object {3}] 
required
List of available firmware versions
release_note
string 
required
Release notes for firmware
url
string 
required
S3 URL to firmware file
version
string 
required
Firmware version string
Example:
dv6_v2.7.0.fw
Match pattern:
dv\d_v[0-9]+\.[0-9]+\.[0-9]+\.fw
result
string 
required
"OK" if request successful, otherwise "Failed"
Example
{
  "firmwares": [
    {
      "release_note": "G-sensor fix & CAT1 modem improvement",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.6.4.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=mtc91ox8ytD%2B%2B0EueFBAxqApxk0%3D&Expires=1949343807",
      "version": "dvxc4_v1.6.4.fw"
    },
    {
      "release_note": "The modem connection improvements & speed OSD feature added",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.6.5.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=GsS3G%2Bqfzjhx4A%2FHW0pPUItUbAg%3D&Expires=1949343814",
      "version": "dvxc4_v1.6.5.fw"
    },
    {
      "release_note": "v1.7.0 firmware release notes:\n-Improved Audio Quality\n-Support ME CAN converter\n-Fixed recording stutters\n-Added DHCP for LAN module\n-Added G-sensor flood protection\n\n",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.7.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=Faiqf3v7g1oirp%2FOxyqH5qCpTus%3D&Expires=1949343819",
      "version": "dvxc4_v1.7.0.fw"
    },
    {
      "release_note": "Version 1.7.3",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.7.3.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=jil7485a1%2ByhaLhl6r5qU9cHde4%3D&Expires=1949343833",
      "version": "dvxc4_v1.7.3.fw"
    },
    {
      "release_note": "PDC firmware to support the modem OTA upgrade",
      "url": "https://firmwares3.roscocloud.com/staging/aprom_dvxc4_v1.7.4.bin?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=CS2K1aSazjDeCjSfRxTGTRdT0QE%3D&Expires=1949343839",
      "version": "aprom_dvxc4_v1.7.4.bin"
    },
    {
      "release_note": "fixed no-recording issue when parking mode just ended and cranking ",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.7.4.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=17AXOHmTLcSl%2FKhRrwkR%2F5J%2Fer0%3D&Expires=1949343840",
      "version": "dvxc4_v1.7.4.fw"
    },
    {
      "release_note": "production version of t1.7.58",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.7.5.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=xZrS2f3PovYMzvBAWV5YI6J6iGg%3D&Expires=1949343847",
      "version": "dvxc4_v1.7.5.fw"
    },
    {
      "release_note": "Release version for NA Modems",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.7.6.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=H3wwPWmURzoHh5DTnGS3gnR3wbU%3D&Expires=1949343853",
      "version": "dvxc4_v1.7.6.fw"
    },
    {
      "release_note": "Firmware 1.8.0 Production Release",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.8.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=4TK8CjALWR5n3ledGwI3ycVNp%2FI%3D&Expires=1949343866",
      "version": "dvxc4_v1.8.0.fw"
    },
    {
      "release_note": "add a hard-reset feature to recover when PDC is locked.",
      "url": "https://firmwares3.roscocloud.com/staging/aprom_dvxc4_v1.8.0.bin?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=E83xAgIr6r3Srjtoz7n52Xducyg%3D&Expires=1949343869",
      "version": "aprom_dvxc4_v1.8.0.bin"
    },
    {
      "release_note": "add support for ND100, DR100 & DM100 and add snapshot streaming to RL",
      "url": "https://firmwares3.roscocloud.com/staging/aprom_dvxc4_v1.9.0.bin?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=7qeQuyeaDj4Rr5NgRotNHZZGq9w%3D&Expires=1949343880",
      "version": "aprom_dvxc4_v1.9.0.bin"
    },
    {
      "release_note": "add support for ND100, DR100 & DM100 and add snapshot streaming to RL",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.9.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=Hz%2Fd3SLQOb%2FUNRDV9zfFeDYE2X4%3D&Expires=1949343881",
      "version": "dvxc4_v1.9.0.fw"
    },
    {
      "release_note": "Test 1.99.77",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v1.99.77.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=qDPGllS5SvVAfFZp%2FLCKvcDsbd4%3D&Expires=1949343885",
      "version": "dv6_v1.99.77.fw"
    },
    {
      "release_note": "79 MCU Firmware",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v79.mcu?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=bnck2XH%2FKjB0GWJyz0xuLDRAL%2BY%3D&Expires=1949343886",
      "version": "dv6_v79.mcu"
    },
    {
      "release_note": "New DV4 camera FW version ",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.9.1.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=I8LjeR5VeYgiX55QWNObNK%2ByjbY%3D&Expires=1950793068",
      "version": "dvxc4_v1.9.1.fw"
    },
    {
      "release_note": "New DV4 PDC FW version ",
      "url": "https://firmwares3.roscocloud.com/staging/aprom_dvxc4_v1.9.1.bin?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=xSX49Qvjidb6PMN1U%2BgNxcClOas%3D&Expires=1950793091",
      "version": "aprom_dvxc4_v1.9.1.bin"
    },
    {
      "release_note": "New FW version with CAN, custom APN, VX1 feature updates",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.1.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=EXUCGgLH%2Fl%2F%2FabPwkSf1kw0HY0o%3D&Expires=1952456253",
      "version": "dv6_v2.1.0.fw"
    },
    {
      "release_note": "SD_E reboot prod version",
      "url": "https://firmwares3.roscocloud.com/staging/dvxc4_v1.9.3.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=8%2BROyibVT8Gg22IPlzgMALc%2Byo4%3D&Expires=1967056910",
      "version": "dvxc4_v1.9.3.fw"
    },
    {
      "release_note": "a new DV6 QR code pairing test fw version",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.2.3.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=jtSn180WMNFPFDijZPSH81%2Fo1QI%3D&Expires=1973516805",
      "version": "dv6_v2.2.3.fw"
    },
    {
      "release_note": "the latest DV6 v2.2.4 FW for production",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.2.4.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=q81d%2BxCc2e0Vf0iEtlI0T%2FFEf6o%3D&Expires=1974391308",
      "version": "dv6_v2.2.4.fw"
    },
    {
      "release_note": "a new DV6 firmware version for production with aDAS and DMS improvements etc.",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.5.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=sqHogtV3ETlw2buPc%2BxuAxOMYME%3D&Expires=2002812149",
      "version": "dv6_v2.5.0.fw"
    },
    {
      "release_note": "a dv6 hotfix for voice prompt and power issue",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.5.1.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=jnIoeEqCjbRu9aqeR%2Bzp4yo4ovo%3D&Expires=2008085631",
      "version": "dv6_v2.5.1.fw"
    },
    {
      "release_note": "Official 2.6.0 release",
      "url": "https://firmwares3.roscocloud.com/staging/dv6_v2.6.0.fw?AWSAccessKeyId=AKIAR34ZBXI7E5ZZ7R7C&Signature=HUZMZsW3O5uBHqgKv0g0ultdXHo%3D&Expires=2036068865",
      "version": "dv6_v2.6.0.fw"
    }
  ]
}
🔴500Internal Server Error
🟠404Resource Not Found
🟠401Login Required
Modified at 2024-07-25 02:26:07
Previous
Device Firmware
Next
get list of latest firmware versions
Built with