Get Company Events

GET

https://fleet.roscolive.com/api/v1.0/partners/companies/{company_name}/events

Get all events of company named company_name within a specific time period.

User Role Permissions

The following table shows which user roles are allowed to send requests using this API endpoint.

Role	Permission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/partners/companies//events?start_ts=20240728092243&end_ts=20240728160819&order=vehicle_name&direction=asc&search=&filters=gsensor,speed&page_number=2&page_size=50&search_by_id=false&search_type=vehicle&is_deleted=false&device_ids=12345,67890&exclude_device_ids=98765,43210&feedback=false&channels=&include_data'

Response Example

200 - Valid get company events

{
    "meta": {
        "code": 200
    },
    "response": {
        "events": [
            {
                "accurate_duration": 10,
                "archive": null,
                "company_id": 825,
                "created_by": 0,
                "createtime": "Wed, 04 Jun 2025 02:24:55 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3595522191",
                "driver_card_id": null,
                "driver_email": null,
                "driver_id": null,
                "driver_name": null,
                "duration": 10,
                "email_sent": "alert",
                "end_ts": "Wed, 04 Jun 2025 02:25:06 GMT",
                "event_display_type": "",
                "event_label": null,
                "event_notes": null,
                "event_type": "Distraction",
                "flagged": false,
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "InternalTrialDV6"
                ],
                "has_feedback": true,
                "has_review": true,
                "hash": "1ac56d2740eb11f0bc14069d5833a13f",
                "id": 2630755,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": "Wed, 11 Jun 2025 17:09:32 GMT",
                "last_reviewed_by": 534,
                "last_reviewed_name": "John Malkovich",
                "last_viewed": {
                    "viewed_ts": null,
                    "viewer": {
                        "first_name": null,
                        "last_name": null
                    }
                },
                "last_viewed_by": null,
                "lat": 40.6359,
                "lon": -74.198,
                "meta_json": true,
                "mp4_1": true,
                "mp4_2": true,
                "mp4_3": true,
                "mp4_4": false,
                "nvr_filename": "0000000000089003-250603-222456-222506-10U700000022.nvr",
                "old_device_id": null,
                "request_ts": null,
                "rule": null,
                "size": 16.6537,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_3": "https://stages3.roscocloud.com/rosco-user-825/...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Wed, 04 Jun 2025 02:24:56 GMT",
                "status": "used",
                "timestamp": "Wed, 04 Jun 2025 02:25:01 GMT",
                "type": "Distraction",
                "uploaded_timestamp": "Wed, 04 Jun 2025 02:26:32 GMT",
                "uploading_status": "VIDEO_UPLOADED",
                "vehicle_name": "Gary New2 Volvo",
                "video_option": "video_snapshot"
            }
        ],
        "total_number": 1
    },
    "result": "OK"
}

Request

Path Params

Query Params

Body Params multipart/form-data

Responses

🟢200valid get company events

application/json

Body

🟠400get company events with none valid start_ts

🟠404get company events with none existing company

🟠401Login Required

Modified at 2025-07-17 17:06:43

Update company event score weights

Request videos of an event

Get Company Events

User Role Permissions#

Request

Responses

User Role Permissions