List Safety Events

get

https://api.analytics.autos/safety-events

Retrieve all safety events recorded by the system, such as harsh braking or collisions, within a specified date range. Use optional filters to narrow results by vehicle or driver. Each event carries an Event Risk rating in the riskScore field: 1 (Very Low), 2 (Low), 3 (Medium), 4 (High), 5 (Critical); riskScore is null when the event has not yet been risk-scored. The date range must be 30 days or less.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

from

date-time

Start date for fetching events. Only the date counts (UTC). Example: 2024-10-01

date-time

End date for fetching events. Only the date counts, and the whole of that day (UTC) is included. Example: 2024-10-12

cursor

string

A cursor to be used for pagination

limit

int32

A limit to be used for pagination

minIntensity

int32

Minimum intensity for fetching events

minRiskScore

int32

Minimum Event Risk band to include (inclusive). Event Risk is 1–5: 1 (Very Low), 2 (Low), 3 (Medium), 4 (High), 5 (Critical). For example, 4 returns only High and Critical events. This is the same value exposed as the riskScore response field — it is the Event Risk band, not a 0–100 score.

eventType

string

Event Type for fetching events

vehicleIds

array of uuids

Provide an array of driver IDs to filter safety events specific to those drivers.

vehicleIds

driverIds

array of uuids

Array of driver ids to filter safety events

driverIds

Headers

Connection-Id

uuid

required

Unique ID of the connection that helps in managing multiple connections.

Responses

400

Bad request (e.g. the date range exceeds 30 days)

429

Rate limited

200Success