Get Company Events

GET

/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

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

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/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,
                "asset_id": 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"
}

Modified at 2025-11-04 14:24:45

Request Custom Event

Send an event

Get Company Events

User Role Permissions#

Request

Responses

User Role Permissions