# RoscoLive API v1.0(v2.42.0)

## API Docs
- Authentication [Login](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474265e0.md): 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.
- Authentication [Logout](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474266e0.md): Logout the current user session.
- Report [Request IFTA report of a company](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/21316401e0.md): Endpoint to request an IFTA report for the current user for the specified `company_id`. Each new report generated by a user from the Reports page overwrites the previously stored report for that user.
- Report [Get IFTA report of a company](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/21316403e0.md): Endpoint to get the last IFTA report for the current user and specified `company_id`.
- Report [Get IFTA report in CSV-file by company](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/21316407e0.md): Endpoint to get the last IFTA report in CSV format for the current user and specified `company_id`.
- Report [Update a report's subscription options](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/38530555e0.md): # User Role Permissions
- Report [Put subscribe to a report](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474433e0.md): Put subscribe to a report. FREQUENCY possible values:'weekly', 'monthly', 'daily', 'biweekly'. DAY_RUN possible values:'Mon','Tue','Wed','Thu','Fri','Sat','Sun', null (null for anything other than weekly, biweekly). REPORT_TYPE possible values: 'standard', 'custom'.
- Report [Get report subscriptions](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474434e0.md): Get report subscriptions. Returns all subscriptions if report_id and report_type are not defined.
- Company [Add custom user profile](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/38504323e0.md): # User Role Permissions
- Company [Get custom user profiles](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/38505578e0.md): # User Role Permissions
- User [Get User Info from Email Address](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474288e0.md): Get an existing RoscoLive user by their email. The current user can request any user for which they have view permissions, including their own user.
- User [Update notification by email](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474301e0.md): Update notifications by email. Params must be stringified json.
- Device [Get stop routes of devices](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/38452748e0.md): # User Role Permissions
- Device [Update a device settings](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474307e0.md): Updates a device. All the attributes are optional, only the posted attributes will be changed.
- Device [Get a device](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474320e0.md): Get information for device `device_id`.
- Device [Get list of company devices](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474321e0.md): Get list of company devices using company ID.
- Device [Get devices for all companies available for user](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474328e0.md): Returns devices for all companies available for user.
- Device [Get device list for multiple companies](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/11790586e0.md): Get a list of devices for multiple companies.
- Driver Scoring / Coaching [Upload a driver from csv file](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/6474460e0.md): Endpoint to upload a new driver(s) from *.csv file. The file should have the following titles of a head row: "first_name", "last_name", "email", "group", "card_id".
- Event [Get list of company events](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/27482244e0.md): Endpoint to get all company events for the specified `company_id` within a specific time period.
- Metadata [Get missing GPS intervals of devices](https://share.apidog.com/0e9b6215-0325-49a1-ac4a-aa2c4ffad5a6/38448494e0.md): The interval between `start_ts` and `end_ts` must not exceed two days. If it does, the default value will be used for `end_ts`.