added

Synthetic Engine Hours in Vehicle Stats

Synthetic engine hours are now available from the Vehicles Stats API endpoints. You can include the query parameter types=syntheticEngineSeconds to get synthetic engine runtime if engine runtime from the ECU is unavailable. This value is approximated by the time the vehicle gateway receives power from the vehicle. See this article for details on synthetic engine runtime. See the Telematics API guide for how to use the types=syntheticEngineSeconds query parameter and details on the telematics API endpoints.

added

Vehicle ➡️ Driver Assignments Beta API

We've released a new beta API endpoint that returns all vehicles' driver assignments for a given time period. You can view the reference documentation here. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

added

External IDs in Camera Media Beta API

The external IDs of each dashcam's vehicle have been added to the payload of the GET /fleet/vehicles/cameras/media/history beta API endpoint. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

added

Routes Beta API

We've released a beta version of a new endpoint to create routes. This new version conforms to our latest API standards. You can preview the reference docs here. Note: This API is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

added

Camera Media Beta API

We've released a new beta API endpoint that allows you to retrieve camera media for a given time period. You can view the reference docs here. Note: This APIs is in beta and is likely to change before it enters a broader release. This beta release gives you the opportunity to experiment and provide feedback – before the final release. The final release will be announced via another changelog entry.

added

Custom Attributes Beta API

We've released a beta version of a new set of endpoints that allow you to create and manage custom attributes for drivers and vehicles. See the new Custom Attributes guide for more details.

added

Approx. Engine Runtime on Equipment

A new stat type is available for the types query param in the /fleet/equipment/stats endpoints: types=gatewayJ1939EngineSeconds. This an approximation of engine runtime for equipment with J1939/CAT cables. It is based on the cumulative time that the Samsara AG device has received power from the engine. This stat is only available for equipment that does not automatically report engine runtime from on-board diagnostics. In order to activate this stat, you must set a manual engine runtime offset for the piece of equipment in the Samsara Dashboard.

added

Risk Zone Addresses

Addresses now support riskZone as an additional option for addressTypes[].

added

/me API endpoint

A /me API endpoint is now available that returns information about the organization that the API access token belongs to. This includes the organization's id, name, and carrierSettings if the organization is a fleet.

added

Conditional Fields in Documents

Documents now support conditional fields that enable follow-up questions for a given multiple-choice answer.