Authenticate to the Samsara API with a token that has HOS and driver data read scopes enabled for your organization
Call the HOS logs endpoint to retrieve Hours of Service log entries for a driver and date range, including duty status changes (off duty, sleeper berth, driving, on duty not driving) with timestamps and location
Retrieve the HOS violations endpoint to identify any rule violations (for example, exceeding drive-time or on-duty limits under the applicable FMCSA ruleset) for audit or compliance reporting
Pull driver information from the drivers endpoint to map driver IDs in HOS logs to names, license numbers, and assigned carrier information required for FMCSA records
Generate the FMCSA-required ELD output file format if your integration needs to produce transferable ELD data records; verify the current FMCSA ELD technical standard for the required file schema
Store HOS records for the retention period required by FMCSA regulations and implement access controls so only authorized personnel can retrieve driver logs
Known gotchas
Samsara is a registered ELD provider under FMCSA's self-certification program; integrations that consume Samsara HOS data for compliance must not modify log records, as FMCSA rules prohibit alteration of certified ELD data
HOS rulesets vary by operation type (property-carrying, passenger-carrying, short-haul exemption, adverse driving conditions); the Samsara API returns violations against the ruleset assigned to each driver — verify drivers are assigned the correct ruleset before relying on violation flags
Driver logs are personal data subject to privacy considerations; ensure your data retention and access policies comply with applicable regulations and your carrier data sharing agreements with drivers
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp