--- title: "List Safety Events" method: GET path: "/safety/events" tags: ["Safety"] --- # List Safety Events `GET /safety/events` List all safety events detected by the provider. ## Query parameters - `cursor` string, cursor - `limit` integer - `modifiedAfter` string, date-time - `modifiedBefore` string, date-time - `startedAfter` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `startedBefore` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `driverIds` string - `vehicleIds` string - `expand` 'vehicle' | 'driver' | 'driver,vehicle' | 'vehicle,driver' - `raw` boolean ## Headers - `X-Application-Id` string - `Connection-Token` string, required ## Response `200` OK - object - `results` object[], required - `id` string, ulid, required - `sourceId` string, required — The ID used to represent the entity in the source system. - `provider` string, required — Every provider has a unique code to identify it across Terminal's system. You can find each provider's code under [provider details](/providers). - `type` 'harsh_brake' | 'harsh_acceleration' | 'harsh_turn' | 'speeding' | 'crash' | 'near_crash' | 'tailgating' | 'cell_phone' | 'distracted' | 'drowsiness' | 'smoking' | 'seat_belt_violation' | 'stop_sign_violation' | 'red_light_violation' | 'unsafe_lane_change' | 'camera_obstruction' | 'eating_and_drinking' | 'rolling_stop' | 'unsafe_parking', required - `sourceType` string — The original event type as defined by the telematics provider's system - `driver` union — Entities in Terminal are expandable. Using the `expand` query parameter you can choose to ingest just an ID or the full entity details. - string, ulid — Unique identifier for the driver in Terminal. - object - `id` string, ulid, required — Unique identifier for the driver in Terminal. - `vehicle` union, required — The ID of the vehicle that was involved in the event. - string, ulid — Unique identifier for the vehicle in Terminal. - object - `id` string, ulid, required — Unique identifier for the vehicle in Terminal. - `startedAt` string, date-time, required — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `startLocation` object - `longitude` number, required - `latitude` number, required - `endedAt` string, date-time — [ISO 8601](https://www.w3.org/TR/NOTE-datetime) date - `endLocation` object - `longitude` number, required - `latitude` number, required - `stats` object - `maximumSpeed` number — Speed in KPH rounded to 2 decimal places. - `averageSpeed` number — Speed in KPH rounded to 2 decimal places. - `roadSpeedLimit` number — Speed in KPH rounded to 2 decimal places. - `gForceForwardBackward` number — The acceleration/breaking force as a factor of gravity (g). - `gForceSideToSide` number — The cornering (lateral) acceleration as a factor of gravity (g). - `heading` number — Heading in degrees - `cameraMedia` object - `frontFacing` object — The front facing camera media. - `available` boolean, required — Indicates whether the camera media file is available for retrieval. - `sourceId` string — The identifier for the camera media file in the source system. - `rearFacing` object — The rear facing camera media. - `available` boolean, required — Indicates whether the camera media file is available for retrieval. - `sourceId` string — The identifier for the camera media file in the source system. - `extensions` object — Includes data enriched via third-party vendors. See [Extensions](/terminal-platform/extensions) - `here` object — Data obtained from the HERE platform. - `speedLimit` number — Speed in KPH rounded to 2 decimal places. - `speedLimitSource` 'posted' | 'derived' — Source for speed limit obtained from the HERE platform. - `truckSpeedLimit` number — Speed in KPH rounded to 2 decimal places. - `roadName` string — Name of the road obtained from the HERE platform. - `linkAttributes` object — Additional road attributes from HERE platform - `countryCode` string — ISO country code of the road location - `vehicleTypes` string — Types of vehicles allowed - `isUrban` string — Indicates if the road is in an urban area - `transportVerified` string — Indicates if transport information is verified - `functionalClass` string — Road functional class according to HERE Maps: - 0: Unknown - 1: Functional Class 1 - 2: Functional Class 2 - 3: Functional Class 3 - 4: Functional Class 4 - 5: Functional Class 5 - `controlledAccess` string — Indicates if the road has controlled access - `limitedAccessRoad` string — Indicates if it's a limited access road - `travelDirection` string — Direction of travel - `isBoatFerry` string — Indicates if it's a boat ferry route - `isRailFerry` string — Indicates if it's a rail ferry route - `isMultiDigitized` string — Indicates if the road is multi-digitized - `isDivided` string — Indicates if the road is divided - `isDividerLegal` string — Indicates if the divider is legal - `isFrontage` string — Indicates if it's a frontage road - `isPaved` string — Indicates if the road is paved - `isRamp` string — Indicates if it's a ramp - `isPrivate` string — Indicates if it's a private road - `hasPoiAccess` string — Indicates if there's POI access - `intersectionCategory` string — Type of intersection according to HERE Maps: - 0: Unknown - 1: Intersection Internal - 2: Manoeuvre - 3: Indescribable - 4: Roundabout - 5: Undefined Traffic Area - 6: Special Traffic Figure - `speedCategory` string — Speed category according to HERE Maps: - 0: Unknown - 1: Over 130 km/h (80 mph) - 2: 101-130 km/h (65-80 mph) - 3: 91-100 km/h (55-64 mph) - 4: 71-90 km/h (41-54 mph) - 5: 51-70 km/h (31-40 mph) - 6: 31-50 km/h (21-30 mph) - 7: 11-30 km/h (6-20 mph) - 8: Under 11 km/h (6 mph) - `laneCategory` string — Lane category according to HERE Maps: - 0: Unknown - 1: One lane - 2: Two or three lanes - 3: Four or more lanes - `coverageIndicator` string — Coverage indicator - `lowMobility` string — Low mobility indicator: - 0: Unknown (Default) - 1: Low mobility driving condition - 2: Not low mobility driving condition - `hasPublicAccess` string — Indicates if there's public access - `routeTypes` string — Types of routes - `weather` object — Weather conditions at the time of the event - `latitude` number — Latitude of weather measurement location - `longitude` number — Longitude of weather measurement location - `temperature` number — Air temperature in Celsius - `dewPoint` number — Dew point temperature in Celsius - `humidity` number — Relative humidity percentage - `pressure` number — Air pressure - `windSpeed` number — Wind velocity in meters per second - `windDirection` number — Wind direction in degrees - `locationId` string — HERE weather location identifier - `precipitationType` string — Precipitation type - `intensityOfPrecipitation` number — Intensity of precipitation (measured in cm/h) - `visibility` number — Visibility (measured in km) - `metadata` object, required — Internal metadata about the record. - `addedAt` string, date-time, required — The date and time the record was ingested into Terminal. Note: this is not the date and time the record was created in the provider's system. - `modifiedAt` string, date-time, required — The date and time the record was last updated in Terminal. Note: this is not the date and time the record was updated in the provider's system. - `raw` object[] - `provider` string, required - `schema` string, required - `extractedAt` string, required - `data` object, required - `next` string, cursor — Cursor used for pagination. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `429` — Too Many Requests - `500` — Internal Server Error - `504` — Gateway Timeout Error --- [API](https://skmtc.dev/withterminal/apis/terminal-telematics-api.md) · [All operations](https://skmtc.dev/withterminal/apis/terminal-telematics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withterminal/terminal-telematics-api/revisions/90249c4a1739/schema)