---
title: "Get safety settings"
method: GET
path: "/fleet/settings/safety"
tags: ["Settings"]
---

# Get safety settings

`GET /fleet/settings/safety`

## Request

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

Get safety settings

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

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.

## Response `200`

OK response.

- SafetySettingsGetSafetySettingsResponseBody
  - `data` SafetySettingsObjectResponseBody[], required: Safety settings for a single organization.
    - `defaultVehicleType` 'off' | 'automatic' | 'passengerCar' | 'lightTruck' | 'heavyDuty', required: Default vehicle type (for newly added or activated vehicles). Valid values: `off`, `automatic`, `passengerCar`, `lightTruck`, `heavyDuty`
    - `distractedDrivingDetectionAlerts` DistractedDrivingDetectionAlertSettingsObjectResponseBody, required: Enables AI detection of distracted driving, surfaces events in Safety Inbox, and enables configurable alerts. By default, Distracted Driving will impact the drivers' safety score.
      - `inattentiveDrivingDetectionAlerts` InattentiveDrivingDetectionAlertSettingsObjectResponseBody: Enables AI detection of inattentive driving events.
        - `hasInCabAudioAlertsEnabled` boolean: Indicates whether in-cab audio alerts for inattentive driving are turned on.
        - `isEnabled` boolean: Indicates whether AI event detection for inattentive driving is turned on.
        - `severity` 'low' | 'medium' | 'high': Severity of inattentive driving events. Options include low (alerts for all events), medium (alerts for medium and high severity events), and high (alerts for high severity events only). Valid values: `low`, `medium`, `high`
        - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.
      - `isEnabled` boolean: Indicates whether AI event detection for distracted driving behaviors is turned on.
      - `mobileUsageDetectionAlerts` MobileUsageDetectionAlertSettingsObjectResponseBody: Enables AI detection of mobile usage events.
        - `hasInCabAudioAlertsEnabled` boolean: Indicates whether in-cab audio alerts for mobile usage are turned on.
        - `isEnabled` boolean: Indicates whether AI event detection for mobile usage is turned on.
        - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.
    - `followingDistanceDetectionAlerts` FollowingDistanceDetectionAlertSettingsObjectResponseBody, required: Enables AI detection of tailgating or unsafe following distances, surfaces events in Safety Inbox, and enables configurable alerts. By default, Following Distance will impact the drivers' safety score.
      - `durationMs` integer: Duration of following distance at which to alert, measured in milliseconds.
      - `hasInCabAudioAlertsEnabled` boolean: Indicates whether in-cab audio alerts for following distance are turned on.
      - `isEnabled` boolean: Indicates whether AI event detection for following distance is turned on.
      - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.
    - `forwardCollisionDetectionAlerts` ForwardCollisionDetectionAlertSettingsObjectResponseBody, required: Enables AI detection of near forward collisions, surfaces events in Safety Inbox, and enables configurable alerts. While the feature is in beta, it is only enabled during daytime driving hours. In-cab alerts are recommended for testing use only.
      - `hasInCabAudioAlertsEnabled` boolean: Indicates whether in-cab audio alerts for forward collision are turned on.
      - `isEnabled` boolean: Indicates whether AI event detection for forward collision is turned on.
      - `sensitivity` 'near' | 'medium' | 'far': Ranges from near forward collision (results in fewer events) to far forward collision (results in more events). Valid values: `near`, `medium`, `far`
    - `harshEventSensitivity` HarshEventSensitivitySettingsObjectResponseBody, required: The configurable sensitivity for Harsh Event Detection on CM11/CM12/CM22 devices. Sensitivity can be measured as a numeric g-force value or the following values: `Normal`, `Less Sensitive`, `More Sensitive`.
      - `harshAccelSensitivityGForce` HarshAccelSensitivityGForceSettingsObjectResponseBody: The harsh acceleration sensitivity settings.
        - `heavyDuty` string: Harsh acceleration sensitivity settings for heavy duty vehicle.
        - `lightDuty` string: Harsh acceleration sensitivity settings for light duty vehicle.
        - `passenger` string: Harsh acceleration sensitivity settings for passenger car.
      - `harshBrakeSensitivityGForce` HarshBrakeSensitivityGForceSettingsObjectResponseBody: The harsh brake sensitivity settings.
        - `heavyDuty` string: Harsh brake sensitivity settings for heavy duty vehicle.
        - `lightDuty` string: Harsh brake sensitivity settings for light duty vehicle.
        - `passenger` string: Harsh brake sensitivity settings for passenger car.
      - `harshTurnSensitivityGForce` HarshTurnSensitivityGForceSettingsObjectResponseBody: The harsh turn sensitivity settings.
        - `heavyDuty` string: Harsh turn sensitivity settings for heavy duty vehicle.
        - `lightDuty` string: Harsh turn sensitivity settings for light duty vehicle.
        - `passenger` string: Harsh turn sensitivity settings for passenger car.
    - `harshEventSensitivityV2` HarshEventSensitivityV2SettingsObjectResponseBody, required: The configurable sensitivity for Harsh Event Detection. Does not apply to CM11/12/22 devices.
      - `harshAccelSensitivity` HarshAccelSensitivityV2SettingsObjectResponseBody: The harsh acceleration sensitivity settings.
        - `heavyDuty` 'unknown' | 'invalid' | 'off' | 'low' | 'normal' | 'high': Harsh acceleration sensitivity settings for heavy duty vehicle. Valid values: `unknown`, `invalid`, `off`, `low`, `normal`, `high`
        - `lightDuty` 'unknown' | 'invalid' | 'off' | 'low' | 'normal' | 'high': Harsh acceleration sensitivity settings for light duty vehicle. Valid values: `unknown`, `invalid`, `off`, `low`, `normal`, `high`
        - `passenger` 'unknown' | 'invalid' | 'off' | 'low' | 'normal' | 'high': Harsh acceleration sensitivity settings for passenger car. Valid values: `unknown`, `invalid`, `off`, `low`, `normal`, `high`
      - `harshBrakeSensitivity` HarshBrakeSensitivityV2SettingsObjectResponseBody: The harsh brake sensitivity settings.
        - `heavyDuty` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh brake sensitivity settings for heavy duty vehicle. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
        - `lightDuty` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh brake sensitivity settings for light duty vehicle. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
        - `passenger` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh brake sensitivity settings for passenger car. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
      - `harshTurnSensitivity` HarshTurnSensitivityV2SettingsObjectResponseBody: The harsh turn sensitivity settings.
        - `heavyDuty` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh turn sensitivity settings for heavy duty vehicle. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
        - `lightDuty` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh turn sensitivity settings for light duty vehicle. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
        - `passenger` 'unknown' | 'invalid' | 'off' | 'veryLow' | 'low' | 'normal' | 'high': Harsh turn sensitivity settings for passenger car. Valid values: `unknown`, `invalid`, `off`, `veryLow`, `low`, `normal`, `high`
    - `policyViolationsDetectionAlerts` PolicyViolationsDetectionAlertSettingsObjectResponseBody, required: Enables detection of policy violations, surfaces events in Safety Inbox, and enables configurable alerts. While the feature is in beta, in-cab alerts are recommended for testing use only.
      - `eventsAvailableForTesting` string[]: List of selectable beta policy violation events to be tested.
      - `eventsToCoach` string[]: List of selectable policy violation events to enable coaching for.
      - `hasInCabAudioAlertsEnabled` boolean: Indicates whether in-cab audio alerts for rolling stops are turned on.
      - `isEnabled` boolean: Indicates whether AI event detection for rolling stops is turned on.
      - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.
    - `rollingStopDetectionAlerts` RollingStopDetectionAlertSettingsObjectResponseBody, required: AI event detection settings for the rolling stop behavior. Detection is available in vehicles with compatible dash cams.
      - `isEnabled` boolean: Indicates whether AI event detection for rolling stops is turned on.
      - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.
    - `safetyScoreConfiguration` SafetyScoreConfigurationSettingsObjectResponseBody, required: The configurable safety infraction weights.
      - `aiInattentiveDrivingDetectionWeight` integer: Score weight for AI-detected inattentive driving behavior.
      - `crashWeight` integer: Score weight for crash behavior.
      - `defensiveDrivingWeight` integer: Score weight for defensive driving behavior. This behavior has a positive impact on the safety score.
      - `didNotYieldWeight` integer: Score weight for driver not yielding.
      - `drowsyWeight` integer: Score weight for drowsy behavior.
      - `eatingDrinkingWeight` integer: Score weight for eating/drinking behavior.
      - `followingDistanceModerateWeight` integer: Score weight for moderate (2-4s) following distance behavior.
      - `followingDistanceSevereWeight` integer: Score weight for severe (0-2s) following distance behavior.
      - `followingDistanceWeight` integer: Score weight for following distance behavior.
      - `forwardCollisionWarningWeight` integer: Score weight for forward collision warning behavior.
      - `harshAccelWeight` integer: Score weight for harsh acceleration behavior.
      - `harshBrakeWeight` integer: Score weight for harsh braking behavior.
      - `harshTurnWeight` integer: Score weight for harsh turn behavior.
      - `heavySpeedingWeight` integer: Score weight for heavy speeding (20-30% over limit).
      - `inattentiveDrivingWeight` integer: Score weight for inattentive driving behavior.
      - `laneDepartureWeight` integer: Score weight for lane departure behavior.
      - `lateResponseWeight` integer: Score weight for late response behavior.
      - `lightSpeedingWeight` integer: Score weight for light speeding (0-10% over limit).
      - `maxSpeedWeight` integer: Score weight for max speed events.
      - `mobileUsageWeight` integer: Score weight for mobile usage behavior.
      - `moderateSpeedingWeight` integer: Score weight for moderate speeding (10-20% over limit).
      - `nearCollisionWeight` integer: Score weight for near collision behavior.
      - `noSeatbeltWeight` integer: Score weight for no seatbelt behavior.
      - `obstructedCameraWeight` integer: Score weight for obstructed camera behavior.
      - `ranRedLightWeight` integer: Score weight for driver running red light.
      - `rollingStopWeight` integer: Score weight for rolling stop behavior.
      - `severeSpeedingWeight` integer: Score weight for severe speeding (over 30% over limit).
      - `smokingWeight` integer: Score weight for smoking behavior.
      - `speedingWeight` integer: Score weight for manual speeding event.
      - `vulnerableRoadUserWeight` integer: Score weight for vulnerable road user behavior.
    - `safetyScoreTarget` integer, required: The fleet-wide target safety score that is shown on safety score graphs. A safety score goal of 0 means that score benchmarking is disabled.
    - `speedingSettings` SpeedingSettingsObjectResponseBody, required: Enables custom speeding levels.
      - `severityLevels` SpeedingSeverityLevelResponseBody[]: The speeding severity levels for an organization.
        - `durationMs` integer, required: The amount of time the vehicle is speeding in this category before being attributed to this level
        - `isEnabled` boolean, required: Indicates the severity level is enabled
        - `severityLevel` 'light' | 'moderate' | 'heavy' | 'severe', required: The severity level name. Valid values: `light`, `moderate`, `heavy`, `severe`
        - `speedOverLimitThreshold` number, float, required: The minimum speed above the speed limit that will get attributed to this severity level.
      - `unit` 'milesPerHour' | 'kilometersPerHour' | 'percentage': The unit of measurement for speeding Valid values: `milesPerHour`, `kilometersPerHour`, `percentage`
    - `voiceCoaching` VoiceCoachingSettingsObjectResponseBody, required: Enabling voice coaching will play messages for harsh events, speeding, and unbuckled seat belts.
      - `eventsToCoach` string[]: Selected driving events will be enabled for voice coaching. Harsh driving events include harsh acceleration and harsh brake.
      - `isEnabled` boolean: Indicates whether voice coaching is turned on.
      - `language` 'english' | 'spanish' | 'dutch' | 'englishUk' | 'italian' | 'french' | 'german': The coaching language. The default language is English. Valid values: `english`, `spanish`, `dutch`, `englishUk`, `italian`, `french`, `german`
      - `speedingThresholdMph` number, double: Alert when speed is over this many miles per hour.

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