How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Samsara Safety API

The Safety API from Samsara — 5 operation(s) for safety.

Samsara Safety API is one of 90 APIs that Samsara publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Safety. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a GitHub repository.

This API exposes 5 operations across 5 paths, and defines 42 schemas. It is described by OpenAPI 3.0.1, at version 2024-11-18.

Requests are made against 2 base URLs: https://api.samsara.com/, https://api.eu.samsara.com/.

5 operations 5 paths 42 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2024-11-18
Base URL
https://api.samsara.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Samsara Safety API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessTokenHeader). By default, every request must be authenticated.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.

Safety 5
GET
/fleet/safety-events
List All Safety Events.
getSafetyEvents 6 params → 200default
GET
/fleet/safety-events/audit-logs/feed
Fetches Safety Activity Event Feed
getSafetyActivityEventFeed 2 params → 200401404405429500501502
GET
/v1/fleet/drivers/{driverId}/safety/score
Fetch Driver Safety Score
V1getDriverSafetyScore 3 params → 200default
GET
/v1/fleet/vehicles/{vehicleId}/safety/harsh_event
Fetch Harsh Events
V1getVehicleHarshEvent 2 params → 200default
GET
/v1/fleet/vehicles/{vehicleId}/safety/score
Fetch Vehicle Safety Scores
V1getVehicleSafetyScore 3 params → 200default

Schemas 42

The contract defines 42 schemas that model the data the API accepts and returns. The most detailed are V1VehicleSafetyScoreResponse (12 properties), V1DriverSafetyScoreResponse (12 properties), SafetyEvent (11 properties), V1VehicleHarshEventResponse (7 properties). Each schema is shown below with its type and property counts.

SafetyEventsGetSafetyActivityEventFeedResponseBody
object
2 properties 2 required
SafetyEventDownloadInwardVideoUrl
string
URL to download the inward video.
V1ErrorResponse
string
Error message describing why the request failed.
V1VehicleHarshEventResponse_location
object
3 properties
vehicleTinyResponse
object
A minified vehicle object.
3 properties
SafetyEventDriverObjectResponseBody
object
A minified driver object.
1 property
SafetyEventBehaviorLabelType
string
The label associated with the safety event. This list often changes, so it is recommended that clients gracefully handle any types not enumerated in this list.…
SafetyEventBehaviorLabelsResponseBody
object
Behavior label for a safety event.
2 properties
SafetyEventMaxAccelerationGForce
number
The maximum acceleration value as a multiplier on the force of gravity (g).
SafetyEventBehaviorLabels
array
The most up-to-date behavior labels associated with the safety event. These labels can be updated by the Safety Report Admin.
standardErrorResponse
object
Error response
2 properties
GoaPaginationResponseResponseBody
object
Pagination parameters.
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedTooManyRequestsErrorResponseBody
object
Too many requests
2 properties 2 required
V1DriverSafetyScoreResponse
object
Safety score details for a driver
12 properties
SafetyEventActivityFeedItemResponseBody
object
Safety event activity feed item.
4 properties 4 required
SafetyEventDownloadTrackedInwardVideoUrl
string
URL to download the tracked inward video.
SafetyEventObjectResponseBody
object
The safety event that was updated.
5 properties
SafetyEventTime
string
The time the safety event occurred in RFC 3339 milliseconds format.
SafetyEventsGetSafetyActivityEventFeedNotImplementedErrorResponseBody
object
Requested endpoint is not yet implemented
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedServiceUnavailableErrorResponseBody
object
Service unavailable
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedUnauthorizedErrorResponseBody
object
Unauthorized
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedMethodNotAllowedErrorResponseBody
object
Method not allowed
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedBadRequestErrorResponseBody
object
Bad Request parameters
2 properties 2 required
SafetyEventBehaviorLabelSource
string
The source of the label associated with the safety event. Valid values: automated, userGenerated.
V1SafetyReportHarshEvent
object
List of harsh events
3 properties
V1VehicleHarshEventResponse
object
Harsh event details for a vehicle
7 properties 2 required
SafetyEvent
object
A safety event.
11 properties
SafetyEventId
string
The unique Samsara ID of the safety event.
driverTinyResponse
object
A minified driver object.
2 properties
SafetyEventVehicleObjectResponseBody
object
A minified vehicle object.
1 property
paginationResponse
object
Pagination parameters.
2 properties 2 required
location
object
Location object
2 properties 2 required
SafetyEventCoachingState
string
The current coaching status of the event. Valid values: needsReview, coached, dismissed, reviewed, archived, manualReview, needsCoaching, autoDismissed, needsR…
SafetyEventsListResponse
object
List of safety events.
2 properties
SafetyEventsGetSafetyActivityEventFeedNotFoundErrorResponseBody
object
Resource not found
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedGatewayTimeoutErrorResponseBody
object
Gateway timeout
2 properties 2 required
SafetyEventsGetSafetyActivityEventFeedInternalServerErrorResponseBody
object
An internal server error occurred
2 properties 2 required
SafetyEventDownloadForwardVideoUrl
string
URL to download the forward video.
SafetyEventBehaviorLabelName
string
The name of the label associated with the safety event.
SafetyEventsGetSafetyActivityEventFeedBadGatewayErrorResponseBody
object
Bad Gateway
2 properties 2 required
SafetyEventBehaviorLabel
object
The label and source of the label associated with the safety event.
3 properties 2 required
V1VehicleSafetyScoreResponse
object
Safety score details for a vehicle
12 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

samsara-safety-api-openapi.yml Raw ↑

Other APIs Samsara publishes across the network.

Samsara Activity API
Samsara Addresses API
Samsara Aemp API
Samsara Applications API
Samsara Assets API
Samsara Assignments API
Samsara Attributes API
Samsara Audit API
Samsara Beta A P Is API
Samsara Camera API
Samsara Cameras API
Samsara Cargo API
Where this information came from

This is an independent, third-party profile of Samsara Safety API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.