1. Authentication
RoscoLive API v1.0(v2.42.0)
  • Authentication
    • Login
      POST
    • Logout
      GET
  • Report
    • Request IFTA report of a company
      POST
    • Get IFTA report of a company
      GET
    • Get IFTA report in CSV-file by company
      GET
    • Update a report's subscription options
      POST
    • Put subscribe to a report
      PUT
    • Get report subscriptions
      GET
  • Company
    • Add custom user profile
      PUT
    • Get custom user profiles
      GET
  • User
    • Get User Info from Email Address
      GET
    • Update notification by email
      POST
  • Device
    • Get stop routes of devices
      GET
    • Update a device settings
      POST
    • Get a device
      GET
    • Get list of company devices
      GET
    • Get devices for all companies available for user
      GET
    • Get device list for multiple companies
      GET
  • Driver Scoring / Coaching
    • Upload a driver from csv file
      PUT
  • Event
    • Get list of company events
      GET
  • Metadata
    • Get missing GPS intervals of devices
      GET
  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 '/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