Samsara API
Samsara is fleet management and IoT software used by trucking, delivery, field service, and industrial companies to track vehicles and assets, coach driver safety with AI dash cams, manage compliance (ELD/HOS, DVIR), and coordinate dispatch. An unofficial API lets you programmatically
What is Samsara?
Samsara is a cloud platform for fleet management and industrial operations that connects vehicles, drivers, assets, and sensors. Organizations use Samsara to monitor location and utilization, improve safety with AI dash cams, maintain ELD/HOS compliance, manage DVIRs and maintenance, and streamline routing and dispatch.
Core product areas include:
- Fleet Telematics (e.g., GPS, trips, utilization, fuel)
- Driver Safety & Video (e.g., AI events, coaching, HD video retrieval)
- Compliance (e.g., ELD/HOS, DVIR, tachograph)
- Routing & Dispatch (e.g., routes, stops, messages)
- Asset & Equipment Tracking (e.g., trailers, powered/non-powered assets)
- Environmental Monitoring (e.g., reefer/temperature, door/open-close)
- Maintenance & Diagnostics (e.g., DTCs, engine hours, service workflows)
Common data entities:
- Organizations, Users, Roles, and Tags
- Drivers and Duty Status
- Vehicles (VIN, plate, attributes) and Trailers/Assets
- Trips, Locations, and Geofences
- Safety Events, Scores, and Video Media
- HOS Logs and DVIRs (defects, certifications)
- Engine Diagnostics (DTCs), Fuel, and Odometer/Hours
- Routes, Stops, Dispatch Messages, Documents
- Sensor Readings (temperature, door, humidity)
The Samsara Integration Challenge
Fleets rely on Samsara every day, but turning portal-based workflows and device-backed data into reliable automation is non-trivial:
- Entity sprawl and mapping: Vehicles, drivers, trailers, and tags each have distinct lifecycles and identifiers (VINs, external IDs, device serials) that must be reconciled.
- Real-time vs. historical: Live GPS/sensor updates stream frequently, while historical trips and video are paginated and sometimes delayed or asynchronous to export.
- Video retrieval complexity: Dash cam footage often requires asynchronous jobs, time-bounded retention windows, and entitlement checks to access specific camera angles.
- Compliance rigor: HOS rules, log edits/corrections, DVIR attestation, and timezone handling demand careful programmatic treatment.
- Rate limits and quotas: Official APIs enforce limits; large fleets must batch, paginate, and backfill efficiently without data loss.
- SSO/MFA and role-based controls: Enterprise auth plus granular permissions complicate headless, unattended integrations.
- Portal-first features: Some coaching states, AI labels, and review flows are more complete in the UI than in standard endpoints.
How Supergood Creates Samsara APIs
Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Samsara tenant.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes responses so you can integrate once and rely on consistent objects across modules
- Aligns with customer entitlements and role-based permissions to ensure compliant access
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your modules, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened Samsara adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Samsara evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Authentication
/sessions/refreshRefresh an existing token to keep sessions uninterrupted.
Vehicles & Telemetry
/fleet/vehiclesList vehicles with current telemetry and summary details.
Safety Events & Video
/safety/eventsRetrieve AI-detected safety events with context and media availability.
Safety Events & Video
/safety/video-requestsRequest a dash cam clip by vehicle, time window, and camera angle. Returns an async job that resolves to a time-limited download URL when ready.
Routes & Dispatch
/dispatch/routesCreate a route with ordered stops and assign to a driver or vehicle.
Use Cases
Fleet Data Sync
- Mirror vehicles, drivers, trailers/assets, and tags into your internal systems - Keep GPS, odometer/hours, and fuel telemetry current for analytics and planning - Normalize identifiers (VIN, externalId, plate) for multi-system consistency
Safety & Video Automation
- Ingest AI-detected safety events (harsh braking, speeding, distraction) - Orchestrate dash cam video requests for coaching, claims, and incident review - Drive SLA alerts and case management based on severity and context
Dispatch & Customer Experience
- Create and assign routes with time windows and service durations - Power live ETAs and geofence-based arrival/departure notifications - Sync job status and proof-of-service artifacts back to your TMS/CRM
Compliance & Maintenance
- Pull HOS logs and duty status for audit and planning - Create/read DVIRs, defects, and certifications - Monitor DTC faults and schedule service automatically
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination across fleet, safety, compliance, and dispatch modules
Rate limits
Tuned for enterprise throughput while honoring customer entitlements and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval for vehicles/telemetry; asynchronous orchestration for video exports; backfill support for historical trips/events
Security
Encrypted transport, scoped tokens, and audit logging; respects Samsara role-based permissions
Webhooks
Optional asynchronous delivery for long-running workflows (e.g., video readiness, route state changes, HOS log updates)
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume vehicle polling, safety event ingestion, and route creation
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions; resumable pagination for large backfills
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used modules such as Fleet Telematics (vehicles, trips, GPS), Safety & Video (events, media), Compliance (HOS, DVIR), Dispatch (routes, stops), and Assets/Sensors (trailers, temperature), subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Yes. We orchestrate camera exports by vehicle, timeframe, and angle (e.g., road/driver). Jobs are queued asynchronously, with webhooks and signed URLs for time-limited downloads. We respect retention windows and permissions.
Yes. We can pull duty status, log segments, and violations and mirror DVIRs/defects with attachments. We normalize timestamps and driver/vehicle mappings to align with your compliance workflows.
We implement adaptive throttling, incremental cursors, and resumable jobs for historical syncs. For streaming-like needs, we blend polling cadence with event/webhook processing to keep systems current without breaching quotas.
We reconcile on externalId, VIN, license plate, and device serials where available, and maintain a mapping table to keep your ERP/TMS identifiers aligned with Samsara records.