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

# Get driver scores

`GET /safety-scores/drivers`

## Request

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

Get safety scores and overall risk factors for drivers.

 <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
- `driverIds` string[]
- `after` string

## Response `200`

OK response.

- SafetyScoresGetDriverSafetyScoresResponseBody
  - `data` DriverSafetyScoreResponseBody[], required: List of driver risk factors.
    - `behaviors` SafetyScoreBehaviorObjectResponseBody[], required: Aggregated list of behaviors for the driver, 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 by the driver.
    - `driveTimeMilliseconds` integer, required: Total time spent driving by the driver.
    - `driverId` string, required: ID of the driver.
    - `driverScore` integer, required: Safety score for the driver. The score is a rounded number between 0-100.
    - `speeding` SafetyScoreSpeedingObjectResponseBody[], required: Aggregated list of speeding events for the driver, 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`
  - `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)