# RoscoLive API v1.0(v2.41.0)

## Docs
- [Webhooks](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/1112502f0.md): 

## API Docs
- Authentication [Login](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/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/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474266e0.md): Logout the current user session.
- Report [Get custom report data](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474432e0.md): Gets a custom report either owned or shared with the user. The report object will contain all of the report fields that were selected for the report when it was created or last updated.
- Report [Get paired GO device report](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/33073292e0.md): Endpoint to get data for RL device and paired GO device.
- Report [Update custom report](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474429e0.md): Update a custom report.
- Report [Create custom report for user](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474442e0.md): Add custom report for a user.
- Company > private [Create a new partner company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11256220e0.md): Creates a new partner company in RoscoLive. This endpoint is only accessible to `system_admin` and `customer_support` roles.
- Company > private [Update partner company info](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11973762e0.md): Update information of a partner company, all the attributes are optional, only the posted attribute will be changed.
- Company > private [Get a partner company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15254494e0.md): Endpoint to get a partner company.
- Company > private [Disable a customer company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15312532e0.md): Endpoint to disable a customer company.
- Company > private [Enable a customer company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15312686e0.md): Endpoint to enable a customer company.
- Company > private [Disable a partner company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15312993e0.md): Endpoint to disable a partner company.
- Company > private [Enable a partner company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15313080e0.md): Endpoint to enable a partner company.
- Company [Create a company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474282e0.md): Create a new company.
- Company [Get a company by ID](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474276e0.md): Return data for company of the passed in `company_id`.
- Company [Update company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474274e0.md): Update a company's information. All fields are optional and only passed in fields will be updated. **NOTE**: Only Partner companies with correct permission can update companies. 
- Company [Get a company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474271e0.md): Returns a single company object.
- Company [Get companies](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474270e0.md): Returns a list of company objects for all companies associated with the partner.
- Company [Get own partner company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/8880428e0.md): Returns the Partner company data the current user belongs to.
- Remote Device Management [Get device config history](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/33219987e0.md): # User Role Permissions
- Remote Device Management [Get device config history file](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/33219996e0.md): # User Role Permissions
- Device [Search devices](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474306e0.md): Searches devices with device id or vehicle name.
- Device [Update a device settings](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/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/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474320e0.md): Get information for device `device_id`.
- Device [Get list of company devices](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474321e0.md): Get list of company devices using company ID.
- Device [Get device with driver ID](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474322e0.md): Get device with driver_id.
- Device [Create devices (auto-prov/DV4/DV6/DV7)](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474324e0.md): Create a device in a company's account. 50 devices and more can be created at the same time.
- Device [Get devices for all companies available for user](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474328e0.md): Returns devices for all companies available for user.
- Device [Get device list for multiple companies](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11790586e0.md): Get a list of devices for multiple companies.
- Device [Get current activity status of devices](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11862662e0.md): Returns a list of current activity statuses for devices according to the passed in `device_ids`.
- Driver Scoring / Coaching [Get company event score weights](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11969418e0.md): Get event score weights for driver scoring in a company. Driver score weights are on a scale of 1 to 5 with 1 being the least impactful.
- Driver Scoring / Coaching [Update company event score weights](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/11969423e0.md): Update event score weights for driver scoring in a company. Driver score weights are on a scale of 1 to 5 with 1 being the least impactful.
- Event [Get Company Events](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474361e0.md): Get all events of company named `company_name` within a specific time period.
- Event [Get Latest Event for Each Device in Company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474374e0.md): Returns a list of the latest event from each device in company named `company_name`.
- Event [Share an event](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474389e0.md): Partner can share an event. The 'expiration' parameter is optional, 1 day by default. Several emails should be separated by ','
- Event [Get a last updated event of devices](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474392e0.md): Endpoint to get a last changed event of all company's devices. An empty response would be returned, if nothing changed.
- Event [Get list of company events](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/27482244e0.md): Endpoint to get all company events for the specified `company_id` within a specific time period.
- External Service > BeWhere [Get BeWhere trackers by group](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34041744e0.md): # User Role Permissions
- External Service > BeWhere [Add BeWhere tracker to group](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34052887e0.md): # User Role Permissions
- External Service > BeWhere [Remove BeWhere tracker from group](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34055154e0.md): # User Role Permissions
- External Service > BeWhere [Get list of BeWhere trackers for a company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34171406e0.md): # User Role Permissions
- External Service > BeWhere [Get available dates for a BeWhere tracker](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34171887e0.md): # User Role Permissions
- External Service > BeWhere [Get metadata for a BeWhere tracker](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/34172852e0.md): # User Role Permissions
- Group [Get devices of a group](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474351e0.md): Returns devices of a group.
- Metadata [Get alerts and events of devices for company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474407e0.md): Returns an response that contains events and alerts sent by the devices for a company in the time window specified.
- Metadata [Get alerts of a device](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474410e0.md): Partner gets alerts of the company device(s). START_TS and END_TS parameters are necessary, format is YYYYmmddHHMMSS, eg: 20180220130200. Alerts can be filtered by type and separated by ','
- Webhooks [Add Webhook Subscription to Multiple Event Types](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15159321e0.md): Provide a URL for a call-back server to listen and receive webhook notifications sent by RoscoLive for the notification types(`type_ids`) subscribed to for the passed in `company_id`. More than one URL can be subscribed to the same notification types for the same company. Use the *Delete Webhook Subscription* endpoint to remove a webhook subscription from the company if it is no longer required.
- Webhooks [Get Notification Subscriptions for Event Type](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474444e0.md): Get all existing webhook subscriptions/notifications for a single Event Type (`type` parameter) for a company (`company_name`)
- Webhooks [Set Notifications for Event Type](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474445e0.md): Set webhook subscription (`url`) for single Event Type (`type`) notification
- Webhooks [Remove Notification Subscription for Event Type](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/6474446e0.md): Remove webhook subscriptions/notifications for a single Event Type `type`.
- Webhooks [Get All Webhook Subscriptions for a Company](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/15159322e0.md): Returns a list of Webhook objects for all subscribed call-back URLs for the company with ID `company_id`
- Installer App [Get user installed devices](https://share.apidog.com/becb7a40-d849-4dff-a03d-a2d7e4aad6f6/32989710e0.md): Endpoint to get user installed devices.