Samsara API

Name: Samsara API
Brand: Samsara API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentIOTSensor Databearer56 EndpointsREST

For Agents

Track vehicle locations, monitor driver safety, enforce HOS compliance, and manage fleet routes and equipment for commercial transportation and logistics operations.

Install Jentic One Beta

Connect the Samsara API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Samsara API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Samsara 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

GET STARTED

Start building with Samsara API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Samsara 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%

Key Endpoints

56 endpoints — jentic publishes the only available openapi specification for samsara api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/fleet/vehicles/locations

Get current GPS locations for all vehicles

GET

/fleet/vehicles/stats

Get vehicle diagnostics and telemetry

GET

/safety/events

List safety events (harsh braking, speeding)

GET

/safety/scores/drivers/{id}

Get a driver's safety score

GET

/hos/clocks

Get remaining HOS drive time for drivers

GET

/hos/violations

List active HOS violations

GET

/drivers

List all drivers

POST

/routes

Create a dispatch route with stops

GET

/fleet/vehicles/locations

Get current GPS locations for all vehicles

GET

/fleet/vehicles/stats

Get vehicle diagnostics and telemetry

GET

/safety/events

List safety events (harsh braking, speeding)

GET

/safety/scores/drivers/{id}

Get a driver's safety score

GET

/hos/clocks

Get remaining HOS drive time for drivers

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Your Samsara bearer token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'track vehicle fleet locations' or 'list duty-status violations', and Jentic returns the matching Samsara operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

FAQs

Specific to using Samsara 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 with Jentic One, the self-hosted execution layer.

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 Jentic One instance 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.

Can I limit what my agent is allowed to do with the Samsara API?

Yes. Because you run Jentic One yourself, you decide exactly which Samsara operations your agent may call, so read paths like GET /fleet/vehicles/locations, GET /fleet/vehicles/stats, and GET /safety/scores/drivers/{id} can be permitted while writes such as POST /routes stay off unless you add them. Since Samsara puts the driver id in the URL path (/safety/scores/drivers/{id}), your rules can also pin the agent to specific drivers, letting it pull only the locations, stats, and safety data you allow. Your own configuration determines which operations and credentials the agent can use, and it can call nothing outside that scope.