Compliance and ELD

Manage hours of service and records of duty status for your fleet using the Samsara Compliance API.

Recipe: Custom Duty Status Report

View on developers.samsara.com

Recipe: HOS Exemption Report

View on developers.samsara.com

The Samsara API allows you to manage hours of service (HOS) and records of duty status. The following is a summary of the API endpoints and types of compliance use cases they can help you address.

Managing Driver Info and ELD Rulesets

The Drivers API endpoints allow you to create, retrieve, update, and deactivate drivers.

These endpoints allow you to manage general driver data such as Driver App credentials, name and contact info, and license information.

Additionally, these endpoints also allow you to manage ELD settings:

ELD Setting Type	Field Name(s)	API Capabilities
ELD exemptions	eldAdverseWeatherExemptionEnabled, eldBigDayExemptionEnabled, eldExempt, eldExemptReason	Read/Write
ELD day start hour	eldDayStartHour	Read/Write
Personal conveyance	eldPcEnabled	Read/Write
Yard moves	eldYmEnabled	Read/Write
ELD rulesets for US State, cycle, restarts, and break	eldSettings	Read-only. Must be set in the cloud dashboard. Attempts to write to this field via the API will be ignored.

See the Drivers API reference documentation for full details.

Real-time Duty Status

The Get HOS clocks endpoint allows you to retrieve the current duty status of all your drivers.

Each call to this endpoint returns current values for:

• Current duty status
• Time until break
• Driving time remaining
• Shift time remaining
• Cycle time remaining

See the Get HOS clocks reference documentation for full details.

Daily Duty Status Summaries

The Get all driver HOS daily logs endpoint allows you to retrieve a summarized report of daily activity for each driver.

The report will include:

• Time spent in each duty status per day
• Distance driven per day, broken up into personal conveyance and yard moves if enabled
• Vehicles assignments for the day
• Trailer assignments for the day
• Shipping doc assignments for the day
• Log certification information

See the Daily Duty Status Summaries guide for some sample code.

Historical Log Retrieval

The Get HOS logs endpoint allows you to retrieve duty status logs for all drivers between a given start time and end time.

A driver’s log will contain their sequence of duty statuses throughout the given time period, including the start and end time of each duty status, the associated vehicle if relevant, and the start location of the log entry.

The data returned by this endpoint reflects the current state of the logs including any driver or carrier edits. This means that if a log is edited by a carrier or driver, you may need to pull the log again to receive the latest version of the log.

See the Get HOS logs reference docs for full details.