# RoscoLive API v1.0

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

## API Docs
- Company [create a company](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474282e0.md): Create a new company.
- Company [get a company by ID](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474276e0.md): Return data for company of the passed in `company_id`
- Company [update company](https://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474271e0.md): Returns a single company object.
- Company [get companies](https://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/8880428e0.md): Returns the Partner company data the current user belongs to. 
- Device [ Get a device](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474320e0.md): Gets a device object and can return supplimental data according to additional params passed.
- Device [get list of company devices](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474321e0.md): Get list of company devices using company ID.
- Device Firmware [get available firmware versions](https://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474450e0.md): Get a list of drivers for a company
- Driver Scoring / Coaching [add a driver](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474458e0.md): Add a new driver to a company.
- Event [Get company events](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474361e0.md): Get all events of this company during a specific time period.
- Event [Request videos of an event](https://apidog.com/apidoc/shared/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 a last event of devices](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474374e0.md): Returns a list of latest events from devices in the company passed into the request.
- Event [get geotab events](https://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474392e0.md): Partner gets a last changed event of all company's devices. An empty response would be returned, if nothing changed
- Event [update an event](https://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/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://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474301e0.md): Update notifications by email. Params must be stringified json
- User [Get event / sms notification settings](https://apidog.com/apidoc/shared/3e2da577-1ecb-4c2a-9fb5-7416b00c7c0c/6474304e0.md): Get email / sms notification settings for a user the requester has permission to view, including their own.