---
title: "Get Safety Event"
method: GET
path: "/safety/events/{id}"
tags: ["Safety"]
---

# Get Safety Event

`GET /safety/events/{id}`

Get a safety event by id.

## Query parameters

- `expand` 'driver' | 'vehicle' | 'driver,vehicle' | 'vehicle,driver'
- `raw` boolean

## Headers

- `X-Application-Id` string
- `Connection-Token` string, required

## Response `200`

OK

- object
  - `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

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server 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)