---
title: "[legacy] Fetch harsh events"
method: GET
path: "/v1/fleet/vehicles/{vehicleId}/safety/harsh_event"
tags: ["Legacy APIs"]
---

# \[legacy\] Fetch harsh events

`GET /v1/fleet/vehicles/{vehicleId}/safety/harsh_event`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/v1/fleet/vehicles/{vehicleId}/safety/harsh_event`
- 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.** > 🚧 This endpoint is still on our legacy API.

Fetch harsh event details for a vehicle. 

 **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>

## Path parameters

- `vehicleId` integer, required

## Query parameters

- `timestamp` integer, required

## Response `200`

Harsh event details.

- V1VehicleHarshEventResponse: Harsh event details for a vehicle
  - `downloadForwardVideoUrl` string: URL for downloading the forward facing video
  - `downloadInwardVideoUrl` string: URL for downloading the inward facing video
  - `downloadTrackedInwardVideoUrl` string: URL for downloading the tracked inward facing video
  - `harshEventType` string, required: Type of the harsh event. One of: [Crash, Harsh Acceleration, Harsh Braking, Harsh Turn, ROP Engine, ROP Brake, YC Engine, YC Brake, Harsh Event]
  - `incidentReportUrl` string, required: URL of the associated incident report page
  - `isDistracted` boolean: Whether the driver was deemed distracted during this harsh event
  - `location` V1VehicleHarshEventResponseLocation
    - `address` string: Address of location where the harsh event occurred
    - `latitude` number: Latitude of location where the harsh event occurred
    - `longitude` number: Longitude of location where the harsh event occurred

## Other responses

- `default`: Unexpected error.

---

[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)