# RoscoLive API v1.0(v2.37.0)

## API Docs
- Company [Create a company](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474282e0.md): Create a new company.
- Company [Get a company by ID](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474276e0.md): Return data for company of the passed in `company_id`.
- Company [Update company](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/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/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474271e0.md): Returns a single company object.
- Company [Get companies](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474270e0.md): Returns a list of company objects for all companies associated with the partner.
- Device > Geotab [Get device by geotab device serial number](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/20661464e0.md): Returns devices by Geotab device serial numbers.
- Device [Update a device settings](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474307e0.md): Updates a device. All the attributes are optional, only the posted attributes will be changed.
- Device [Get reported DTCs for devices](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/16491478e0.md): Returns a list of DTCs reported by the devices for the time range specified in the request. It is important to note these are historical records and are not removed from the database if a reported DTC is later resolved and no longer active.
- Device [Get company devices](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474305e0.md): Get all devices in company `company_name`. 
- Device [Search devices](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474306e0.md): Searches devices with device id or vehicle name.
- Device [Play in-cab audible alert sound for device](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/12419742e0.md): A utility endpoint that will push a command to the camera to  play an audible in-cab alert sound immediately upon receipt of the request.
- Device [Get list of trip dates for device](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474318e0.md): Get all the trips made by device `device_id` from `start_ts` to `end_ts`
- Device [Get list of trips for passed device and date](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474319e0.md): Get list of trips for passed device and date.
- Device [ Get a device](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474320e0.md): Get information for device `device_id`.
- Device [Get devices for all companies available for user](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474328e0.md): Returns devices for all companies available for user.
- Device [Get available video list for date](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474332e0.md): Get available video list for date range [`start_ts`, `end_ts`].
- Device [Get device list for multiple companies](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/11790586e0.md): Get a list of devices for multiple companies.
- Driver Scoring / Coaching [Get driver scores](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474456e0.md): Get driver scores.
- Driver Scoring / Coaching [Get unknown driver trips](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474461e0.md): Retrieve a list of trips for unknown drivers. Available only for companies with the `Enable Driver ID` parameter set to `Card Reader` mode (`driver_recognition`=`cardreader`).
- Event [Request Custom Event](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/18079965e0.md): Endpoint to request custom event for device with ID `device_id` starting at `start_ts`.
- Event [Get Company Events](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474361e0.md): Get all events of company named `company_name` within a specific time period.
- Event [Send an event](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474363e0.md): Partner requests event and gets snapshot by device ID. The format of timestamp is YYYYmmDDHHMMSS, UTC, eg: 20170808150120.
- Event [Get snapshot/location of event](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474400e0.md): Get snapshot and location of events for selected date.
- Event [Get Device Events for Period](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474401e0.md): View all the events of a device in a specific time period.
- Event [Request custom video from device](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474402e0.md): Send a request to a camera for video and/or snapshots for a selected date-time window. After the request is sent, it will be processed and the request will be sent to the camera to retrieve the requested media. 
- Event [Get event filters list for date range in company](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/13687830e0.md): Returns a list of applicable filter categories for events in the given duration.
- Group [Get devices of a group](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474351e0.md): Returns devices of a group.
- Metadata [Get metadata of a device](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474405e0.md): Gets metadata of a device in a specific period. 
- Metadata [Get metadata of devices](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474406e0.md): Returns current metadata values for passed in Device IDs within the duration requested. Time duration is regulated to a maximum of 24 hours. If `end_ts` not passed into request, duration will default to `start_ts + 24h`.
- Metadata [Get alerts of a driver](https://share.apidog.com/2886ef0f-2ecc-42ca-b587-ef6f5cd71727/6474411e0.md): Get alerts of a driver.