---
title: "Get vehicle scores"
method: GET
path: "/safety-scores/vehicles"
tags: ["Safety Scores"]
---

# Get vehicle scores

`GET /safety-scores/vehicles`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/safety-scores/vehicles`
- Auth: HTTP bearer

Get safety scores and overall risk factors for vehicles.

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

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>
 

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

## Query parameters

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

## Response `200`

OK response.

- SafetyScoresGetVehicleSafetyScoresResponseBody
  - `data` VehicleSafetyScoreResponseBody[], required: List of vehicle risk factors.
    - `behaviors` SafetyScoreBehaviorObjectResponseBody[], required: Aggregated list of behaviors for the vehicle, one row for each unique type of behavior.
      - `behaviorType` 'acceleration' | 'braking' | 'crash' | 'defensiveDriving' | 'didNotYield' | 'distractedDrivingAutomatic' | 'distractedDrivingManual' | 'drowsy' | 'eatingDrinking' | 'followingDistance' | 'followingDistanceModerate' | 'followingDistanceSevere' | 'forwardCollisionWarning' | 'harshTurn' | 'laneDeparture' | 'lateResponse' | 'mobileUsage' | 'nearCollision' | 'noSeatbelt' | 'obstructedCamera' | 'ranRedLight' | 'rollingStop' | 'smoking' | 'speedingManual' | 'unknown', required: Type of the behavior. Valid values: `acceleration`, `braking`, `crash`, `defensiveDriving`, `didNotYield`, `distractedDrivingAutomatic`, `distractedDrivingManual`, `drowsy`, `eatingDrinking`, `followingDistance`, `followingDistanceModerate`, `followingDistanceSevere`, `forwardCollisionWarning`, `harshTurn`, `laneDeparture`, `lateResponse`, `mobileUsage`, `nearCollision`, `noSeatbelt`, `obstructedCamera`, `ranRedLight`, `rollingStop`, `smoking`, `speedingManual`, `unknown`
      - `count` integer, required: Count of occurrences of the behavior.
      - `scoreImpact` number, double, required: Total points increased or deducted from the score due to the total count of behaviors of this type. Weights for this calculation are defined in organisation settings. Negative numbers indicate points deducted and positive indicates points increased (e.g. defensive driving).
    - `driveDistanceMeters` integer, required: Total sum of distance driven with the vehicle.
    - `driveTimeMilliseconds` integer, required: Total time spent driving with the vehicle.
    - `speeding` SafetyScoreSpeedingObjectResponseBody[], required: Aggregated list of speeding events for the vehicle, one row for each unique type of speeding.
      - `durationMilliseconds` integer, required: Total time spent speeding for the speeding type.
      - `scoreImpact` number, double, required: Total points increased or deducted from the score due to the total time spent speeding of this type. Weights for this calculation are defined in organisation settings. Negative numbers indicate points deducted.
      - `speedingType` 'light' | 'moderate' | 'heavy' | 'severe' | 'maxSpeed' | 'unknown', required: Type of speeding. Valid values: `light`, `moderate`, `heavy`, `severe`, `maxSpeed`, `unknown`
    - `vehicleId` string, required: ID of the vehicle.
    - `vehicleScore` integer, required: Safety score for the vehicle. The score is a rounded number between 0-100.
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` 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

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request 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)