---
title: "[legacy] List all safety events."
method: GET
path: "/fleet/safety-events"
tags: ["Legacy APIs"]
---

# \[legacy\] List all safety events.

`GET /fleet/safety-events`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/safety-events`
- Auth: HTTP bearer

**Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getsafetyeventsv2stream) instead. The endpoint will continue to function as documented.** 

 Fetch safety events for the organization in a given time period. 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

## Query parameters

- `after` string
- `startTime` string, required
- `endTime` string, required
- `tagIds` string[]
- `parentTagIds` string[]
- `vehicleIds` string[]

## Response `200`

List of safety events from given time period.

- SafetyEventsListResponse: List of safety events.
  - `data` SafetyEvent[]
    - `behaviorLabels` SafetyEventBehaviorLabel[]: The most up-to-date behavior labels associated with the safety event. These labels can be updated by the Safety Report Admin.
      - `label` 'genericTailgating' | 'genericDistraction' | 'defensiveDriving' | 'rollingStop' | 'nearCollison' | 'speeding' | 'obstructedCamera' | 'didNotYield' | 'noSeatbelt' | 'mobileUsage' | 'drowsy' | 'laneDeparture' | 'followingDistanceSevere' | 'followingDistanceModerate' | 'lateResponse' | 'acceleration' | 'braking' | 'harshTurn' | 'crash' | 'rolloverProtection' | 'yawControl' | 'ranRedLight' | 'forwardCollisionWarning' | 'eatingDrinking' | 'smoking' | 'followingDistance' | 'edgeDistractedDriving', required: The label associated with the safety event. This list often changes, so it is recommended that clients gracefully handle any types not enumerated in this list. Valid values: `genericTailgating`, `genericDistraction`, `defensiveDriving`, `rollingStop`, `nearCollison`, `speeding`, `obstructedCamera`, `didNotYield`, `noSeatbelt`, `mobileUsage`, `drowsy`, `laneDeparture`, `followingDistanceSevere`, `followingDistanceModerate`, `lateResponse`, `acceleration`, `braking`, `harshTurn`, `crash`, `rolloverProtection`, `yawControl`, `ranRedLight`, `forwardCollisionWarning`, `eatingDrinking`, `smoking`, `followingDistance`, `edgeDistractedDriving`.
      - `name` string: The name of the label associated with the safety event.
      - `source` 'automated' | 'userGenerated', required: The source of the label associated with the safety event. Valid values: `automated`, `userGenerated`.
    - `coachingState` 'needsReview' | 'coached' | 'dismissed' | 'reviewed' | 'archived' | 'manualReview' | 'needsCoaching' | 'autoDismissed' | 'needsRecognition' | 'recognized' | 'invalid': The current coaching status of the event. Valid values: `needsReview`, `coached`, `dismissed`, `reviewed`, `archived`, `manualReview`, `needsCoaching`, `autoDismissed`, `needsRecognition`, `recognized`, `invalid`.
    - `downloadForwardVideoUrl` string: URL to download the forward video.
    - `downloadInwardVideoUrl` string: URL to download the inward video.
    - `downloadTrackedInwardVideoUrl` string: URL to download the tracked inward video.
    - `driver` DriverTinyResponse: A minified driver object.
      - `id` string: ID of the driver.
      - `name` string: Name of the driver.
    - `id` string: The unique Samsara ID of the safety event.
    - `location` Location: Location object
      - `latitude` number, double, required: GPS latitude represented in degrees
      - `longitude` number, double, required: GPS longitude represented in degrees
    - `maxAccelerationGForce` number: The maximum acceleration value as a multiplier on the force of gravity (g).
    - `time` string: The time the safety event occurred in RFC 3339 milliseconds format.
    - `vehicle` VehicleTinyResponse: A minified vehicle object.
      - `ExternalIds` object: The [external IDs](https://developers.samsara.com/docs/external-ids) for the given object.
      - `id` string: ID of the vehicle.
      - `name` string: Name of the vehicle.
  - `pagination` PaginationResponse: Pagination parameters.
    - `endCursor` string, string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)