Get Device Events for Period

GET

https://fleet.roscolive.com/api/v1.0/devices/{device_id}/events

View all the events of a device in a specific time period.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://fleet.roscolive.com/api/v1.0/devices//events?start_ts=&end_ts=&page_number=&page_size=&filter_type=&filter_exclude_type=&order=&direction=&include_data'

Response Example

200 - Valid get events for a device

{
    "meta": {
        "code": 200
    },
    "response": {
        "events": [
            {
                "accurate_duration": null,
                "archive": null,
                "company_id": 825,
                "created_by": 6294,
                "createtime": "Thu, 15 May 2025 07:31:42 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3539397876",
                "driver_card_id": null,
                "driver_id": null,
                "driver_name": "",
                "duration": 300,
                "email_sent": "alert",
                "end_ts": "Wed, 14 May 2025 08:20:00 GMT",
                "event_display_type": null,
                "event_label": null,
                "event_type": "SNAPSHOTS_CLIP",
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "Installed Devices"
                ],
                "has_feedback": false,
                "has_review": false,
                "hash": "5e90934553cb49e782521a73891dcacc",
                "id": 2630276,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": null,
                "last_reviewed_by": null,
                "last_viewed": null,
                "last_viewed_by": null,
                "lat": null,
                "lon": null,
                "meta_json": false,
                "mp4_1": false,
                "mp4_2": false,
                "mp4_3": false,
                "mp4_4": false,
                "nvr_filename": null,
                "old_device_id": null,
                "request_ts": null,
                "rule": null,
                "size": 0.6955,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630276/1_1.jpeg?...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630276/2_1.jpeg?...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Wed, 14 May 2025 08:15:00 GMT",
                "status": "used",
                "timestamp": "Wed, 14 May 2025 08:15:00 GMT",
                "type": "Custom Clip",
                "uploaded_timestamp": null,
                "uploading_status": null,
                "vehicle_name": "Test TT1",
                "video_option": "snapshot_only"
            },
            {
                "accurate_duration": 294,
                "archive": null,
                "company_id": 825,
                "created_by": 534,
                "createtime": "Tue, 20 May 2025 08:54:08 GMT",
                "custom_event_type": null,
                "data": null,
                "device_id": "3539397876",
                "driver_card_id": "0",
                "driver_id": null,
                "driver_name": "",
                "duration": 299,
                "email_sent": "alert",
                "end_ts": "Tue, 20 May 2025 02:19:59 GMT",
                "event_display_type": null,
                "event_label": null,
                "event_type": "SYSTEMADMIN_CLIP",
                "geotab_driver": null,
                "geotab_user_id": null,
                "groups": [
                    "Installed Devices"
                ],
                "has_feedback": false,
                "has_review": false,
                "hash": "a40fee4842074f888d021173a63525c6",
                "id": 2630619,
                "impact_score": true,
                "is_datausage_locked": false,
                "is_flood": false,
                "last_reviewed": null,
                "last_reviewed_by": null,
                "last_viewed": null,
                "last_viewed_by": null,
                "lat": null,
                "lon": null,
                "meta_json": true,
                "mp4_1": true,
                "mp4_2": true,
                "mp4_3": false,
                "mp4_4": false,
                "nvr_filename": "0000000000135755-250519-221459-221959-10O400000002.nvr",
                "old_device_id": null,
                "request_ts": null,
                "rule": null,
                "size": 292.1456,
                "snapshot_1": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630619/1.jpeg?...",
                "snapshot_2": "https://stages3.roscocloud.com/rosco-user-825/3539397876/2630619/2.jpeg?...",
                "snapshot_status": "SNAPSHOT_UPLOADED",
                "start_ts": "Tue, 20 May 2025 02:15:00 GMT",
                "status": "used",
                "timestamp": "Tue, 20 May 2025 02:15:00 GMT",
                "type": "Custom Clip",
                "uploaded_timestamp": "Tue, 20 May 2025 10:43:05 GMT",
                "uploading_status": "VIDEO_UPLOADED",
                "vehicle_name": "Test TT1",
                "video_option": null
            }
        ],
        "total_number": 2
    },
    "result": "OK"
}

Request

Path Params

Query Params

Responses

🟢200200

application/json

Body

🟠400400 (incorrect device id)

🟠404404 (device doesn't exist)

🟠400400 (incorrect type_filter)

🟠400400 (incorrect order))

🟠400400 (incorrect direction)

🟠401Login Required

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

Request videos of an event

Create new profile in a company