RoscoLive API v1.0(v2.35.0)
  1. External Service
RoscoLive API v1.0(v2.35.0)
  • Event
    • Request custom video from device
      PUT
  • Company
    • create a company
      PUT
    • get a company by ID
      GET
    • update a company by ID
      POST
    • update company
      POST
    • get a company
      GET
    • get companies
      GET
    • get own partner company
      GET
  • Device
    • Geotab
      • Pair cameras to GO devices by CSV file
    • Play in-cab audible alert sound for device
      POST
    • Get a device
      GET
  • External Service
    • Get an external service account
      GET
    • Pair RL device with external device
      PUT
    • Get RL device data via external device unique serial number
      GET
  • Fleet Configuration
    • Create new profile in a company
      POST
    • Update a company profile
      POST
    • Get a company profile
      GET
    • Get profiles of a company
      GET
    • get profile history
      GET
  1. External Service

Get RL device data via external device unique serial number

GET
https://fleet.roscolive.com/api/v1.0/external_service/{service_type}/device/{serial_number}
external service
Endpoint to get RoscoLive device data via external (Webfleet / Ituran) device unique serial number.
Bearer token in the Authorization header is optional. To receive device data, if user and device belong to different companies, the user should provide bearer token in the Authorization header.

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 Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/external_service//device/'
Response Response Example
200 - For Webfleet device
{
  "meta": {
    "code": 200
  },
  "response": {
    "device_id": 3737462924,
    "serial_number": "41258401",
    "type": "webfleet"
  },
  "result": "OK"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
service_type
enum<string> 
required
Allowed values:
webfleetituran
serial_number
string 
required
Serial number of external device

Responses

🟢200Success
application/json
Body
meta
object 
required
Request metadata object
code
integer 
required
HTTP status code returned by response
response
required
Contains response data
One of
device_id
integer 
required
RoscoLive device ID
Example:
3186397672
serial_number
string 
required
External device SN (serial number)
Example:
18563767
type
enum<string> 
required
External service type
Allowed value:
webfleet
Default:
webfleet
result
string 
required
"OK" if successful, else "Failed" if error
🟠401Login Required
🟠404Resource Not Found
🔴500Internal Server Error
Previous
Pair RL device with external device
Next
Create new profile in a company
Built with