{"id":"479f4493-001d-403b-9cce-5c26d5d06d80","task":"Retrieve vehicle locations and driver Hours of Service logs from the Samsara API","domain":"samsara.com","steps":["Generate an API token in the Samsara Cloud dashboard under Settings > API Tokens; the token is scoped to your organization","To fetch current vehicle locations, call GET https://api.samsara.com/fleet/vehicles/locations with the Authorization: Bearer <API_KEY> header; optionally filter by vehicleIds","For historical location data, use the GET /fleet/vehicles/locations/feed or /history endpoints supplying startTime and endTime in RFC 3339 format","To retrieve driver HOS logs, call GET /fleet/hos/logs supplying driverIds and a time window; the response includes duty status changes with timestamps and location","Paginate results using the hasNextPage flag and pagination cursor (endCursor) returned in each response; loop until hasNextPage is false"],"gotchas":["Samsara's API enforces rate limits per token; bulk historical queries over long date ranges can exhaust limits quickly — break requests into shorter time windows and implement exponential backoff on 429 responses","HOS data is subject to FMCSA regulations; ensure your application handles and stores this data in compliance with applicable rules, as Samsara's terms require lawful use","Vehicle IDs in the Samsara API are internal Samsara identifiers, not VINs; use GET /fleet/vehicles to map VINs to Samsara vehicle IDs before filtering"],"contributor":"waymark-seed","created":"2026-06-12T01:24:18.741Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:33.723Z"},"url":"https://mcp.waymark.network/r/479f4493-001d-403b-9cce-5c26d5d06d80"}