GET
/driver-events List Driver Events
Returns a Spring Page envelope (content, page, size, totalElements, totalPages) of DriverEventDTOs. Filterable across ~25 fields with the full criteria-operator grammar — append an operator suffix to a field, e.g. event.in, status.equals, deviceDateTime.greaterThanOrEqual, speed.greaterThan, correctDetection.equals. The explorer exposes the highest-value filters; see the Filtering & Sorting guide for the complete operator list.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
event.equals | query | string | Filter by AI event type. LIGHT_SPEEDINGMODERATE_SPEEDINGHEAVY_SPEEDINGSEVERE_SPEEDINGHARSH_BRAKEHARSH_TURNCRASHMOBILE_USAGEINATTENTIVE_DRIVINGDROWSYFOLLOWING_DISTANCEWEATHER_CONDITIONSHOULDER_STOPHARSH_ACCELERATIONNO_SEAT_BELTROLLING_STOPCAMERA_OBSTRUCTEDPASSENGER_DETECTIONLEFT_LANELANE_DEPARTURESMOKINGDRINKING |
eventType.equals | query | string | High-level category: harsh-driving or speeding. HARSHSPEED |
status.equals | query | string | Review status of the event. DISMISSDEFENSIVE_DRIVINGNEED_REVIEW |
detectedCameraType.equals | query | string | Camera that captured the event. INSIDEOUTSIDEALL |
direction.equals | query | string | Heading at the time of the event. NESWNESESWNW |
correctDetection.equals | query | boolean | Whether the detection was reviewed as correct. truefalse |
driverId.equals | query | integer | Filter by driver id. |
truckId.equals | query | integer | Filter by truck id. |
companyId.equals | query | integer | Filter by owning company id. |
globalEventId.equals | query | string | Exact cross-system event id match. |
speed.greaterThan | query | integer | Speed (mph) strictly greater than. |
deviceDateTime.greaterThanOrEqual | query | string | Event at or after this instant (ISO 8601 date-time).
e.g. 2026-06-25T00:00:00Z |
deviceDateTime.lessThanOrEqual | query | string | Event at or before this instant (ISO 8601 date-time). |
page | query | integer | Zero-based page index (0..N).
e.g. 0 |
size | query | integer | Page size. Default 20.
e.g. 20 |
sort | query | string | Sort as `property,(asc|desc)`. Repeatable for multi-key sort.
e.g. deviceDateTime,desc |
The explorer shows the most common query parameters. For the full
operator grammar (
.equals, .contains, .greaterThan, .in, .specified …) see the
Filtering & Sorting
guide.
Response
Status: Stable. Try the request in the panel on the right to see a live response.