added

[Beta Release] Trailer Stats

Three new Beta APIs are now available: Get trailer stats snapshot, Get trailer stats feed, and Get trailer stats history. These APIs allow you to request telematics data for Trailers, using the same query patterns as the Vehicle Stats APIs (see this guide for an overview). These Beta APIs are available to give you an opportunity to test and provide feedback, but should not be used in production applications. See the API Release Cycle for more details.

added

Updates to GET /hos/daily-logs

The GET /hos/daily-logs endpoint has been updated to include an optional parameter expand=vehicle parameter and the following additional response body fields: adverseDrivingClaimed, bigDayClaimed, isUsShortHaulActive, carrierName, carrierFormattedAddress, carrierUsDotNumber, homeTerminalName, homeTerminalFormattedAddress. Details below! 🔎

added

New Routes APIs (Generally Available)

Three new Routes API endpoints are now generally available (GA). These are new implementations of the legacy v1 Routing APIs. The endpoints that are now generally available are: Create a route, Update a route, and Get route updates. The rest of the latest generation of Routing APIs are still in Beta. They are available for testing and feedback, but they are subject to change before they are made generally available. These endpoints include: [beta] Fetch all routes and [beta] Fetch a route. These new implementations of the Routing APIs follow Samsara's latest REST API standards and patterns for pagination and update feeds.

improved

ECU Speed included in GPS stat

The gps.speedMilesPerHour vehicle stat endpoints will now display ECU speed if Samsara has the ability to retrieve it from the vehicle. If Samsara cannot retrieve ECU speed, the field will display GPS-calculated speed. Previously, this field displayed GPS-calculated speed even if ECU speed was available.

added

IFTA API Endpoints

We've released two new API endpoints for IFTA reports!

added

Preview API: /gateways

You can now preview our designs for a set of /gateways APIs that allow you to list, activate, and deactivate Samsara gateways programmatically. This would allow you to automate gateway installation and management. Check out the preview design, and use the feedback form to send in feedback and express interest in beta-testing.

improved

Changes to Documents API error codes

We've improved the error codes that get returned for a couple of different scenarios in the Documents APIs:

API Version: 2021-02-16

We've released a new version of the API. This version updates the behavior of the Retrieve a unit of equipment API endpoint. Previously, this endpoint worked for any gateway within Samsara. This was not intended behavior. Now the endpoint only works for Equipment: assets connected to a Samsara Asset Gateway (AG) via APWR, CAT, or J1939 cables.

added

Daily Driver Activity API

The new Get all driver HOS daily logs API endpoint allows you to get a daily summary of activity for each driver. Check out the Daily Duty Status Summaries API Guide for more details and sample code.

added

Driver deactivatedAtTime

The Drivers APIs now support a deactivatedAtTime field that indicates when a driver was deactivated.