For Agents
Track vehicle locations, monitor driver safety, enforce HOS compliance, and manage fleet routes and equipment for commercial transportation and logistics operations.
Get started with Samsara API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"track vehicle fleet GPS locations"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Samsara API API.
Track real-time GPS locations and historical location feeds for entire vehicle fleets
Monitor vehicle diagnostics including fuel level, odometer, engine hours, and fault codes
Score driver safety behavior based on harsh events, speeding, and distraction incidents
Enforce Hours of Service compliance by querying driver HOS clocks, logs, and violations
GET STARTED
Use for: I need to get the current location of all vehicles in my fleet, I want to check a driver's Hours of Service compliance status, List all safety events for a specific driver this week, Find vehicles that have been idling for more than 15 minutes
Not supported: Does not handle route optimization algorithms, fuel card transactions, or vehicle insurance — use for fleet telematics, compliance monitoring, and asset tracking only.
Jentic publishes the only available OpenAPI document for Samsara API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Samsara API, keeping it validated and agent-ready. Track and manage commercial vehicle fleets, drivers, trailers, and industrial equipment through 56 endpoints covering real-time GPS locations, vehicle diagnostics, driver safety scores, Hours of Service (HOS) compliance, DVIRs, route planning, alert configuration, and webhook-based event notifications. The API serves fleet operators managing last-mile delivery, long-haul trucking, and field service operations.
Plan and dispatch delivery routes with stop sequences and estimated arrival times
Configure alert rules for geofence breaches, speeding, idle time, and maintenance triggers
Record and track Driver Vehicle Inspection Reports (DVIRs) for DOT compliance
Patterns agents use Samsara API API for, with concrete tasks.
★ AI Agent Fleet Monitoring
AI agents monitor commercial fleet operations through Jentic's intent search, discovering endpoints for vehicle locations, driver safety, and compliance in real time. An agent searches for 'get vehicle fleet locations', receives the GET /fleet/vehicles/locations schema, and polls the location feed to identify vehicles deviating from planned routes or approaching delivery windows. Jentic handles bearer token authentication and pagination of large fleet responses automatically.
Retrieve the current GPS locations for all vehicles, identify any vehicle more than 5 miles from its assigned route, and return the vehicle ID, driver name, and distance deviation
Driver Safety and Compliance Scoring
Score and monitor driver behavior using safety events (harsh braking, speeding, phone use) aggregated into per-driver safety scores via GET /safety/scores/drivers/{id}. The API provides individual safety events through GET /safety/events with timestamps, GPS coordinates, and severity classifications. Fleet managers use these scores for coaching programs, insurance negotiations, and DOT audit preparation.
Get the safety score for driver 789 for the current month, then list all harsh-braking and speeding events for that driver to identify patterns
Hours of Service Compliance Monitoring
Enforce DOT Hours of Service regulations by querying driver HOS clocks (remaining drive time), daily logs, and active violations via the /hos/clocks, /hos/logs, and /hos/violations endpoints. The API enables proactive compliance management — identifying drivers approaching duty limits before violations occur, enabling dispatch to reassign loads or schedule mandatory rest breaks.
Query the HOS clocks for all active drivers, identify any driver with less than 2 hours of remaining drive time, and check for open HOS violations
Vehicle Diagnostics and Maintenance Alerts
Monitor vehicle health by polling engine diagnostics, fuel levels, odometer readings, and fault codes through GET /fleet/vehicles/stats and the stats feed endpoint. Configure alert rules via POST /alert-configurations to trigger notifications when diagnostic values exceed thresholds — such as low fuel, overdue oil changes, or active engine fault codes requiring immediate maintenance attention.
Get the latest stats for vehicle VH-001 including fuel percentage and odometer, then create an alert configuration that triggers when fuel drops below 15%
56 endpoints — jentic publishes the only available openapi specification for samsara api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/fleet/vehicles/locations
Get current GPS locations for all vehicles
/fleet/vehicles/stats
Get vehicle diagnostics and telemetry
/safety/events
List safety events (harsh braking, speeding)
/safety/scores/drivers/{id}
Get a driver's safety score
/hos/clocks
Get remaining HOS drive time for drivers
/hos/violations
List active HOS violations
/drivers
List all drivers
/routes
Create a dispatch route with stops
/fleet/vehicles/locations
Get current GPS locations for all vehicles
/fleet/vehicles/stats
Get vehicle diagnostics and telemetry
/safety/events
List safety events (harsh braking, speeding)
/safety/scores/drivers/{id}
Get a driver's safety score
/hos/clocks
Get remaining HOS drive time for drivers
Three things that make agents converge on Jentic-routed access.
Credential isolation
Samsara API tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped bearer tokens — raw API tokens with fleet-wide access never enter the agent's context window.
Intent-based discovery
Agents search by intent (e.g., 'track vehicle fleet locations') and Jentic returns matching Samsara operations with pagination and feed schemas, so the agent can monitor fleets without managing cursor-based pagination manually.
Time to first call
Direct Samsara integration: 2-4 days for auth setup, pagination handling, and feed/history endpoint patterns. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Tesla Fleet API
Direct vehicle control and telemetry for Tesla EV fleets
Use Tesla Fleet API for Tesla-specific vehicle commands (unlock, climate, charging). Use Samsara for mixed-fleet telematics across all vehicle makes with driver safety and HOS compliance.
Smartcar API
Consumer vehicle data API supporting 40+ car brands for connected car apps
Choose Smartcar for consumer-facing connected car applications across multiple brands. Choose Samsara for commercial fleet management with driver safety, HOS compliance, and industrial equipment tracking.
Particle Cloud API
IoT device control platform for custom sensor hardware deployed alongside fleet vehicles
Use Particle alongside Samsara when you need custom IoT sensors (temperature monitors, door sensors) on vehicles or trailers that go beyond Samsara's built-in telematics hardware.
Specific to using Samsara API API through Jentic.
Why is there no official OpenAPI spec for Samsara API?
Samsara does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Samsara API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Samsara API use?
The Samsara API uses Bearer token authentication. API tokens are generated in the Samsara dashboard under Settings > API Tokens with configurable permission scopes (read, write, or full access). Through Jentic, these tokens are stored in the encrypted MAXsystem vault and agents receive scoped access without handling raw token strings.
Can I get real-time vehicle locations for my entire fleet?
Yes. The GET /fleet/vehicles/locations endpoint returns the current GPS position, heading, and speed for all vehicles. For continuous monitoring, use GET /fleet/vehicles/locations/feed which returns only vehicles that have moved since your last request, reducing bandwidth for large fleets. Historical location data is available via GET /fleet/vehicles/locations/history with time range filters.
How do I check driver Hours of Service compliance through Jentic?
Search Jentic for 'check driver hours of service compliance' to discover the HOS endpoints. GET /hos/clocks returns remaining drive time and duty time for all active drivers. GET /hos/violations lists any current regulatory violations. Use these together to proactively identify drivers approaching duty limits before violations occur.
What vehicle diagnostic data is available through this API?
GET /fleet/vehicles/stats returns odometer readings, fuel level percentage, engine hours, ambient temperature, tire pressure (where equipped), and active fault codes. The stats feed endpoint (GET /fleet/vehicles/stats/feed) provides incremental updates only for vehicles with changed values, and stats history supports time-range queries for trend analysis.
Can I set up automated alerts for fleet events?
Yes. POST /alert-configurations creates alert rules for conditions like geofence entry/exit, speeding over a threshold, excessive idle time, or diagnostic fault codes. Alerts trigger webhook notifications (configured via POST /webhooks) for real-time integration with dispatch systems, Slack channels, or custom automation workflows.
/hos/violations
List active HOS violations
/drivers
List all drivers
/routes
Create a dispatch route with stops