1. Authentication
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. Authentication

Login

POST
/login
Login a user to begin a user session. Once logged in, a session and session_token cookie will be returned. Pass these cookies in the request header for any subsequent API requests for actions using this current user session. User session tokens expire after 24 hours in which a Login request will have to be resubmitted to retrieve a new session.

Request

Body Params multipart/form-data

Responses

🟢200Login Success
application/json
Bodyapplication/json

🟢202Accepted
🟢200Invalid Credentials
🟠404Resource Not Found
🔴500Internal Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://fleet.roscolive.com/api/v1.0/login' \
--form 'email=""' \
--form 'password=""'
Response Response Example
200 - Login Success
{
    "meta": {
        "code": 200
    },
    "response": {
        "roles": [
            "fleet_manager"
        ],
        "user": "Kianna_Cruickshank@hotmail.com",
        "last_login": "1996-03-04 11:08:13",
        "user_id": 7,
        "session_expire": "2047-09-23 21:13:07",
        "session_token": "afced4feb4dc4c329abec784b2495243"
    },
    "result": "OK"
}
Modified at 2025-01-14 20:04:00
Next
Logout
Built with