Supergood | Samsara API
Programmatically access Samsara fleet telematics, safety, compliance, and asset data with a stable REST API. Supergood builds and operates production-grade, unofficial Samsara integrations so your team can automate dispatch, safety workflows, compliance syncs, and analytics without heavy custom engineering.
Plain English: 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 pull live vehicle locations and telemetry, trips, safety events (with video), HOS logs and DVIRs, routes and stops, engine diagnostics, and temperature/sensor data—and push new routes, messages, geofences, and inspection records back into Samsara.
For a tech company integrating with Samsara, this means you can ingest real-time vehicle and driver signals to power ETA dashboards, automate safety event triage and video retrieval, sync HOS and DVIR data to compliance systems, optimize dispatch from your TMS, or enrich your application with engine fault codes and cold-chain telemetry. You can also push routes and jobs to drivers, create geofences for SLAs, attach documents to inspections, and keep downstream systems (ERP, TMS, WMS, analytics) in lockstep.
What is Samsara?
Samsara (https://developers.samsara.com/reference/overview) 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
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
Available Endpoints
Authentication
POST /sessions: Establish 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.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/sessions \
--header 'Authorization: Basic <Base64 encoded token>' \
--header 'Content-Type: application/json' \
--data '{
"username": "[email protected]",
"password": "<password>",
"mfa": { "type": "totp", "code": "123456" }
}'
Example response
{
"authToken": "eyJhbGciOi...",
"expiresIn": 3600,
"user": {
"id": "u_cab94d",
"name": "Fleet Ops",
"entitlements": ["fleet", "safety", "compliance", "dispatch"]
}
}
POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.
Vehicles & Telemetry
GET /fleet/vehicles: List vehicles with current telemetry and summary details.
Query parameters
- tagId: string
- status: active | archived
- include: telemetry | none
- updatedFrom, updatedTo: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"vehicleId": "vh_12a3bc",
"externalId": "TRK-2047",
"name": "Truck 2047",
"vin": "1HTMKADN43H561234",
"licensePlate": "7ABC204",
"status": "active",
"tagIds": ["tag_longhaul", "tag_west"],
"driver": {
"driverId": "drv_8f00a1",
"name": "Alex Rivera",
"dutyStatus": "on_duty",
"assignedAt": "2026-01-23T09:12:00Z"
},
"telemetry": {
"location": {
"lat": 37.77652,
"lon": -122.41669,
"heading": 92,
"speedMph": 38.2,
"updatedAt": "2026-01-23T13:44:59Z"
},
"engine": {
"ignition": true,
"odometerMeters": 4235600,
"engineHours": 5321.5,
"fuelPercent": 41.0
},
"diagnostics": {
"dtcCodes": [
{"code": "P0442", "severity": "low", "active": false}
]
}
},
"camera": {"road": "online", "driver": "online"},
"lastSeenAt": "2026-01-23T13:44:59Z",
"updatedAt": "2026-01-23T13:45:01Z"
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
Safety Events & Video
GET /safety/events: Retrieve AI-detected safety events with context and media availability.
Query parameters
- vehicleId, driverId: string
- type: harsh_braking | speeding | tailgating | distraction | collision_detected
- severity: info | low | medium | high | critical
- from, to: ISO 8601 timestamps
- page, pageSize: integers for pagination
Example response
{
"items": [
{
"eventId": "se_77b9a2",
"type": "harsh_braking",
"severity": "medium",
"vehicleId": "vh_12a3bc",
"driverId": "drv_8f00a1",
"occurredAt": "2026-01-23T13:40:22Z",
"location": {"lat": 37.77511, "lon": -122.41802},
"speedMph": 42.7,
"gForce": 0.52,
"labels": ["following_distance_short"],
"video": {
"available": true,
"previewImageUrl": "https://signed.example/safety/se_77b9a2_preview.jpg",
"angles": ["road", "driver"]
}
}
],
"page": 1,
"pageSize": 50,
"total": 1
}
POST /safety/video-requests: Request 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.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/safety/video-requests \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"vehicleId": "vh_12a3bc",
"camera": "road",
"startTime": "2026-01-23T13:39:45Z",
"endTime": "2026-01-23T13:40:45Z",
"resolution": "1080p",
"audio": false,
"webhookUrl": "https://webhooks.yourco.com/samsara/video-ready",
"referenceId": "claim-98122"
}'
Example response
{
"requestId": "vr_5ac3f1",
"status": "queued",
"estimatedReadySeconds": 90,
"downloadUrl": null,
"expiresAt": null,
"referenceId": "claim-98122"
}
Routes & Dispatch
POST /dispatch/routes: Create a route with ordered stops and assign to a driver or vehicle.
curl --request POST \
--url https://api.supergood.ai/integrations/<integration_id>/dispatch/routes \
--header 'Authorization: Bearer <authToken>' \
--header 'Content-Type: application/json' \
--data '{
"name": "Bay Area AM Deliveries",
"dispatchTo": {"driverId": "drv_8f00a1"},
"startAt": "2026-01-24T08:00:00-08:00",
"stops": [
{
"sequence": 1,
"address": {
"line1": "1355 Market St",
"city": "San Francisco",
"region": "CA",
"postalCode": "94103",
"country": "US"
},
"windowStart": "2026-01-24T08:30:00-08:00",
"windowEnd": "2026-01-24T09:30:00-08:00",
"serviceTimeSec": 900,
"notes": "Dock on Stevenson St.",
"referenceId": "ord-10045"
},
{
"sequence": 2,
"geofenceId": "gf_7d9aa3",
"windowStart": "2026-01-24T10:00:00-08:00",
"windowEnd": "2026-01-24T11:00:00-08:00",
"serviceTimeSec": 600,
"referenceId": "ord-10046"
}
]
}'
Example response
{
"routeId": "rt_4fdd82",
"status": "pending_dispatch",
"assigned": {"driverId": "drv_8f00a1"},
"createdAt": "2026-01-23T14:02:11Z"
}
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)
Performance Characteristics
- 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
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.
Frequently Asked Questions
Q: Which Samsara modules can this integration cover?
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.
Q: How are MFA and SSO handled for automation?
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Sessions are refreshed automatically with secure challenge handling.
Q: Can you retrieve dash cam video and images?
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.
Q: Do you support HOS and DVIR data?
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.
Q: What about rate limits and large backfills?
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.
Q: How do you map our drivers and vehicles across systems?
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.
Related Integrations
Intralinks API - Programmatically access the Intralinks VDR with Supergood
Ready to automate your Samsara workflows?
Supergood can have your Samsara integration live in days with no ongoing engineering maintenance.
