RoscoLive API v1.0
  1. Event
RoscoLive API v1.0
  • Device
    • Get a device
      GET
  • Driver Scoring / Coaching
    • Get drivers coaching events
      GET
  • Event
    • Get company events
      GET
    • Get flagged company events
      GET
    • Request custom video from device
      PUT
    • Add event label
      POST
    • Add user feedback to event
      POST
    • Get event user feedback
      GET
    • Get event filters list for date range in company
      GET
  1. Event

Get event filters list for date range in company

GET
/partners/companies/{company_name}/events/filters
eventfilters
Returns a list of applicable filter categories for events in the given duration.

User Role Permissions#

The following table shows which user roles are allowed to send requests using this API endpoint.
RolePermission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/partners/companies//events/filters?start_ts&end_ts&device_ids=1234567890,0789456123,9874563210'
Response Response Example
200 - Example 1
{
    "meta": {
        "code": 100
    },
    "response": [
        {
            "fulltype": "string",
            "geotab": 0,
            "type": "string"
        }
    ],
    "result": "OK"
}

Request

Path Params
company_name
string 
required
Name of company in RoscoLive
Query Params
start_ts
string <YYYYMMDDhhmmss>
optional
Start date/time for the desired time period in UTC
>= 14 characters<= 14 characters
Example:
20250112154200
end_ts
string <YYYYMMDDhhmmss>
optional
End date/time for desired time period in UTC
>= 14 characters<= 14 characters
Example:
20250112170000
device_ids
string 
optional
A comma-separated list of device IDs in the company to return data for
Example:
1234567890,0789456123,9874563210

Responses

🟢200Success
application/json
Body
meta
object 
required
Request metadata object
code
integer 
required
HTTP status code returned by response
>= 100<= 599
response
array [object {3}] 
required
Contains response data
fulltype
string 
required
Full event type name
geotab
integer 
required
Used for Geotab integration
type
string 
required
Type name mapped to RoscoLive event type
result
enum<string> 
required
"OK" if successful, else "Fail" if error
Allowed values:
OKFailed
🔴500Internal Server Error
🟠404Resource Not Found
🟠401Login Required
Modified at 2025-06-15 10:46:58
Previous
Get event user feedback
Built with