# RoscoLive API v1.0

## Docs
- [Device Firmware](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/1740019f0.md): Endpoints to manage and update device firmware.

## API Docs
- Company [Create a company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474282e0.md): Create a new company.
- Company [Get a company by ID](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474276e0.md): Return data for company of the passed in `company_id`.
- Company [Update company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/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/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474271e0.md): Returns a single company object.
- Company [Get companies](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474270e0.md): Returns a list of company objects for all companies associated with the partner.
- Company [get partner companies list](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8880905e0.md): Returns a list of company objects related to the current user's partner with select data.
- Company [Get own partner company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8880428e0.md): Returns the Partner company data the current user belongs to.
- Device [Get a device](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474320e0.md): Get information for device `device_id`.
- Device [Get list of company devices](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474321e0.md): Get list of company devices using company ID.
- Device Firmware [get available firmware versions](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8891766e0.md): Get available firmware versions. **NOTE**: Only Partners with valid permissions can access this endpoint.
- Device Firmware [get list of latest firmware versions](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8891890e0.md): Returns a list of latest firmware versions for device types. **NOTE**: Only Partners with valid permissions can successfully call this endpoint.
- Device Firmware [push firmware to device](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8891798e0.md): Push firmware update to devices. *NOTE*: Only Partners with valid permissions can successfully push firmware updates.
- Device Firmware [cancel pending firmware update to devices](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8891882e0.md): Cancel pending firmware updates to devices. Firmware updates cannot be reversed if push has been completed. **NOTE**: Only Partners with valid permissions may access this endpoint.
- Device Firmware [get firmware updates history for company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8892021e0.md): Returns list of firmware updates to devices in company for all time. **NOTE**: Only Partners with valid permissions can access this endpoint.
- Driver Scoring / Coaching [Get company drivers list](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474450e0.md): Endpoint to get a list of drivers for a company.
- Driver Scoring / Coaching [Add new driver to company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474458e0.md): Endpoint to add a new driver to the company with ID equal to `company_id`.
- Event [Get Company Events](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474361e0.md): Get all events of company named `company_name` within a specific time period.
- Event [Request videos of an event](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474365e0.md): Request video of a previously created custom event. Value of `event_id` parameter can be obtained from response of "Request Custom Video" or from any API that returns a list of events for the company.
- Event [Get Latest Event for Each Device in Company](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474374e0.md): Returns a list of the latest event from each device in company named `company_name`.
- Event [get geotab events](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474391e0.md): Partner gets a list of geotab events with their types
- Event [Get a last updated event of devices](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474392e0.md): Endpoint to get a last changed event of all company's devices. An empty response would be returned, if nothing changed.
- Event [update an event](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474399e0.md): Adds or updates the driver and impact score for the existing event.
- Live streaming [start live streaming](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474412e0.md): Starts a live streaming for a device. To save the cellular data plan of the device, the live streaming link must be open in 5s, and the m3au list needs to be refreshed every 5s, or it will be regarded as not playing and the connection will close and expire.
- Report [get list of companies with data usage for date range](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8828878e0.md): Returns a list of all available companies to the user with data usage information for that billing cycle.
- User [Update notification by email](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474301e0.md): Update notifications by email. Params must be stringified json.
- User [Get event / sms notification settings](https://share.apidog.com/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474304e0.md): Get email / sms notification settings for a user the requester has permission to view, including their own.