---
title: "Fetch vehicle safety scores"
method: GET
path: "/v1/fleet/vehicles/{vehicleId}/safety/score"
tags: ["Safety"]
---

# Fetch vehicle safety scores

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

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/v1/fleet/vehicles/{vehicleId}/safety/score`
- Auth: HTTP bearer

> 🚧 This endpoint is still on our legacy API.

Fetch the safety score for the vehicle. 

 <b>Rate limit:</b> 5 requests/sec (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>). 

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

- `startMs` integer, required
- `endMs` integer, required

## Response `200`

Safety score details.

- V1VehicleSafetyScoreResponse: Safety score details for a vehicle
  - `crashCount` integer: Crash event count
  - `harshAccelCount` integer: Harsh acceleration event count
  - `harshBrakingCount` integer: Harsh braking event count
  - `harshEvents` V1SafetyReportHarshEvent[]
    - `harshEventType` string: Sensor generated harsh event type.
    - `timestampMs` integer: Timestamp that the harsh event occurred in Unix milliseconds since epoch
    - `vehicleId` integer: Vehicle associated with the harsh event
  - `harshTurningCount` integer: Harsh turning event count
  - `safetyScore` integer: The vehicle’s Safety Score for the requested period. Note that if the vehicle has zero drive time in this period, the Safety Score will be returned as 100.
  - `safetyScoreRank` string: Safety Score Rank
  - `timeOverSpeedLimitMs` integer: Amount of time driven over the speed limit in milliseconds
  - `totalDistanceDrivenMeters` integer: Total distance driven in meters
  - `totalHarshEventCount` integer: Total harsh event count
  - `totalTimeDrivenMs` integer: Amount of time driven in milliseconds
  - `vehicleId` integer: Vehicle ID

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