For AI agents: visit https://developers.samsara.com/llms.txt for an index of all pages formatted in Markdown and endpoints in OpenAPI.
Jump to Content
Developers | Samsara
GuidesExample ScriptsREST APIChangelogCommunityWebhooksStreamingDeveloper NewsletterBecome a Technology Partner
SUPPORTFEEDBACKDevelopers | Samsara
REST API
SUPPORTFEEDBACK
GuidesExample ScriptsREST APIChangelogCommunityWebhooksStreamingDeveloper NewsletterBecome a Technology Partner

Samsara API

  • Overview
  • Assets
    • List stats for a given reeferget
    • List historical locations for a given assetget
  • Issues
  • Fleet
    • /fleet/locationsget

Core

  • Addresses
    • Create an addresspost
    • Delete an addressdel
    • List all addressesget
    • Retrieve an addressget
    • Update an addresspatch
  • Alerts
    • Create alert configurations.post
    • Delete alert configurations.del
    • Get Alert Configurations.get
    • Get Alert Incidents.get
    • Update alert configurations.patch
  • Attributes
    • Create an attributepost
    • Deleting an attributedel
    • List all attributes by entity typeget
    • Retrieve an attributeget
    • Update an attributepatch
  • Contacts
    • Create a contactpost
    • Delete a contactdel
    • List all contactsget
    • Retrieve a contactget
    • Update a contactpatch
  • Gateways
    • Activate a new gatewaypost
    • Deactivate a gatewaydel
    • List all gatewaysget
  • Live Sharing Links
    • Create Live Sharing Linkpost
    • Delete non-expired Live Sharing Linkdel
    • Get Live Sharing Linksget
    • Update non-expired Live Sharing Linkpatch
  • Organization Info
    • Get information about your organizationget
  • Settings
    • Get compliance settingsget
    • Get driver app settingsget
    • Get safety settingsget
    • Update compliance settingspatch
    • Update driver app settingspatch
  • Tags
    • Create a tagpost
    • Delete a tagdel
    • List all tagsget
    • Retrieve a tagget
    • Update a tagpatch
    • Update a tagput
  • Trips
    • Get Trips Streamget
    • Get vehicle tripsget
  • Users
    • Create a userpost
    • Delete a userdel
    • List all user rolesget
    • List all usersget
    • Retrieve a userget
    • Update a userpatch
  • Webhooks
    • Create a webhookpost
    • Delete a webhook with the given IDdel
    • List all webhooks belonging to a specific org.get
    • Retrieve a webhook with given IDget
    • Update a specific webhook's information.patch

Assets: Vehicles, Trailers, Equipment

  • Assets
    • Create a new asset.post
    • Delete an existing asset.del
    • List all assets.get
    • List current location for all assetsget
    • List historical locations for a given assetget
    • List stats for a given reeferget
    • List stats for all reefersget
    • Update an existing asset.patch
    • [Legacy] List all assetsget
    • [beta] List asset inputs data in an organization.get
  • Equipment
    • Follow a feed of equipment statsget
    • Follow feed of equipment locationsget
    • Get historical equipment locationsget
    • Get historical equipment statsget
    • Get most recent locations for all equipmentget
    • Get most recent stats for all equipmentget
    • List all equipmentget
    • Retrieve a unit of equipmentget
  • Location and Speed
    • List asset location and speed data in an organization.get
  • Readings
    • Get Readings Definitionsget
    • Get Readings History and Feedget
    • Get Readings Snapshotget
  • Sensors
    • Get all sensorspost
    • Get cargo statuspost
    • Get door statuspost
    • Get humiditypost
    • Get sensor historypost
    • Get temperaturepost
  • Trailer Assignments
    • Create a new driver-trailer assignmentpost
    • Get currently active driver-trailer assignments for driver.get
    • List trailer assignments for a given trailerget
    • List trailer assignments for all trailersget
    • Update an existing driver-trailer assignment.patch
  • Trailers
    • Creates a new trailer assetpost
    • Delete a trailerdel
    • List all trailersget
    • Retrieve a trailerget
    • Update a trailerpatch
  • Vehicle Locations
    • Historical locationsget
    • Locations feedget
    • Locations snapshotget
  • Vehicle Stats
    • Historical statsget
    • Stats feedget
    • Stats snapshotget
  • Vehicles
    • List all vehicles.get
    • Retrieve a vehicleget
    • Update a vehiclepatch

Drivers

  • Auth Token for Driver
    • Create auth token for a driverpost
  • Driver QR Codes
    • Create new QR code for driverpost
    • Get driver QR codesget
    • Revoke driver's QR codedel
  • Driver-Vehicle Assignments
    • Create a new driver-vehicle assignmentpost
    • Delete API generated driver-vehicle assignmentsdel
    • Get all driver-vehicle assignmentsget
    • Update API generated driver-vehicle assignmentspatch
  • Drivers
    • Create a driverpost
    • List all driversget
    • Retrieve a driverget
    • Sign out a driverpost
    • Update a driverpatch
  • Messages
    • Get all messages.get
    • Send a message to a list of driver ids.post

Compliance

  • Hours of Service
    • Get HOS clocksget
    • Get HOS logsget
    • Get HOS signin and signoutget
    • Get all driver HOS daily logsget
    • Get all driver HOS violationsget
    • Set a duty status for a specific driverpost
    • [beta] Get driver HOS ELD eventsget
  • Tachograph (EU Only)
    • Get driver tachograph activityget
    • Get tachograph driver filesget
    • Get tachograph vehicle filesget

Fuel and efficiency

  • Fuel and Energy
    • Create a fuel purchase transaction.post
    • Get Driver efficiency data grouped by drivers.get
    • Get Driver efficiency data grouped by vehicles.get
    • Get fuel and energy efficiency driver reports.get
    • Get fuel and energy efficiency vehicle reports.get
  • IFTA
    • Create a job to generate csv files of IFTA mileage segments.post
    • Get IFTA jurisdiction reports.get
    • Get IFTA vehicle reports.get
    • Get information about an existing IFTA detail job.get
  • Idling
    • Get idling events.get
    • [legacy] Get vehicle idling reports.get

Workflows

  • Carrier Proposed Assignments
    • Create an assignmentpost
    • Delete an assignmentdel
    • Retrieve assignmentsget
  • Documents
    • Create a document PDFpost
    • Create documentpost
    • Delete documentdel
    • Fetch all documentsget
    • Fetch documentget
    • Fetch document typesget
    • Query a document PDFget
  • Forms
    • Create a PDF export for an existing form submission.post
    • Create a form submission.post
    • Get a list of form templates.get
    • Get a list of specified form submissions.get
    • Get a stream of filtered form submissions.get
    • Return a PDF export that has already been generated for a form submission.get
    • Update a single form submission.patch
  • Issues
    • Create a single issue.post
    • Get a list of specified issues.get
    • Get a stream of filtered issues.get
    • Update a single issue.patch

ROUTING

  • Hubs
    • Create locations in bulkpost
    • Create orders in bulkpost
    • List all hubs for the organizationget
    • List capacities for a specific hubget
    • List custom properties for a specific hubget
    • List locations for a specific hubget
    • List skills for a specific hubget
    • Update a locationpatch
  • Plans
    • Create a new planpost
    • List plans for a specific hubget
    • List routes for a specific planget
  • Route Events
    • Get route events streamget
  • Routes
    • Create a routepost
    • Delete a route.del
    • Fetch a routeget
    • Fetch all routesget
    • Get route updatesget
    • Update a routepatch

Maintenance

  • Maintenance
    • Create a mechanic DVIRpost
    • Get DVIR defect types.get
    • Get a single DVIR by ID.get
    • Get a single DVIR defect by ID.get
    • Get vehicles with engine faults or check lightsget
    • Resolve a DVIRpatch
    • Stream DVIR defects.get
    • Stream DVIRsget
    • Update a defectpatch
  • Work Orders
    • Creates a work order.post
    • Deletes a work order.del
    • Gets service tasks.get
    • Gets work orders.get
    • Process an invoice scan.post
    • Stream work orders.get
    • Updates a work order.patch

Safety

  • Coaching
    • Get coaching sessions.get
    • Get driver coach assignments.get
    • Put driver coach assignments.put
  • Media
    • Create a media retrieval requestpost
    • Get details for a media retrieval requestget
    • List uploaded media by time range.get
  • Safety
    • Fetch driver safety scoreget
    • Fetch vehicle safety scoresget
    • Get Safety Eventsget
    • Get Safety Events Streamget
    • [legacy] Fetch harsh eventsget
    • [legacy] Fetches safety activity event feedget
    • [legacy] List all safety events.get
  • Safety Scores
    • Get driver scoresget
    • Get tag scoresget
    • Get tags combined scoreget
    • Get vehicle scoresget
  • Speeding Intervals
    • Get Speeding Intervalsget
  • Training Assignments
    • Create training assignments.post
    • Delete training assignments.del
    • Get a stream of filtered training assignments.get
    • Update training assignments.patch
  • Training Courses
    • Get a list of filtered training courses.get

Future

  • Beta APIs
    • Get trailer statsget
    • Get trailer stats feedget
    • Get trailer stats historyget
    • List CARB CTC enrolled vehiclesget
    • List CARB CTC vehicle collection historyget
    • [beta] Accept a Data Sharing Agreementpost
    • [beta] Archive a qualification record.post
    • [beta] Batch create shared assetspost
    • [beta] Batch update shared assetspatch
    • [beta] Cancel a Data Sharing Agreementpost
    • [beta] Create a Data Sharing Agreementpost
    • [beta] Create a Function.post
    • [beta] Create a Functions storage file.post
    • [beta] Create a custom report runpost
    • [beta] Create a partpost
    • [beta] Create a part inventory locationpost
    • [beta] Create a placepost
    • [beta] Create a preferred fuel station.post
    • [beta] Create a qualification record.post
    • [beta] Create a ridership passenger.post
    • [beta] Create a ridership route setup.post
    • [beta] Create a route template for a specific hubpost
    • [beta] Create a stock movementpost
    • [beta] Create a watchpointpost
    • [beta] Create an asset assignment.post
    • [beta] Delete a Data Sharing Agreementdel
    • [beta] Delete a Function.del
    • [beta] Delete a Functions storage file.del
    • [beta] Delete a partdel
    • [beta] Delete a placedel
    • [beta] Delete a preferred fuel station.del
    • [beta] Delete a qualification record.del
    • [beta] Delete a ridership passenger.del
    • [beta] Delete a ridership route setup.del
    • [beta] Delete a route templatedel
    • [beta] Delete orders from a plandel
    • [beta] Deploy a Function.post
    • [beta] Forward geocode an addressget
    • [beta] Get Function logs.get
    • [beta] Get a Function run.get
    • [beta] Get a Function.get
    • [beta] Get a Functions storage file.get
    • [beta] Get a list of AEMP equipmentget
    • [beta] Get a list of qualification types.get
    • [beta] Get a list of specified qualification records.get
    • [beta] Get a preferred fuel station.get
    • [beta] Get a ridership passenger.get
    • [beta] Get a ridership route setup.get
    • [beta] Get a stream of filtered qualification records.get
    • [beta] Get custom report configsget
    • [beta] Get custom report datasetsget
    • [beta] Get custom report run dataget
    • [beta] Get custom report runsget
    • [beta] Get depreciation transactions.get
    • [beta] Get engine immobilizer statesget
    • [beta] Get voice agent session detailsget
    • [beta] Gets work order templates.get
    • [beta] Ingest Readingspost
    • [beta] List Functions storage files.get
    • [beta] List Ground Intelligence issuesget
    • [beta] List active asset assignments.get
    • [beta] List all Data Sharing Agreementsget
    • [beta] List all maintenance vendors.get
    • [beta] List all vendor categories.get
    • [beta] List asset associations.get
    • [beta] List devices.get
    • [beta] List driver app workflowsget
    • [beta] List or batch-get placesget
    • [beta] List orders for a specific planget
    • [beta] List part inventoryget
    • [beta] List partsget
    • [beta] List preferred fuel stations.get
    • [beta] List preventive maintenance schedulesget
    • [beta] List ridership passengers.get
    • [beta] List ridership route setups.get
    • [beta] List route templates for a specific hubget
    • [beta] List shared assets for an agreementget
    • [beta] List tachograph live dataget
    • [beta] List time entriesget
    • [beta] List upcoming preventive maintenanceget
    • [beta] Look up geofence suggestionsget
    • [beta] Poll place deletionsget
    • [beta] Publish a driver app workflow to driverspost
    • [beta] Reject a Data Sharing Agreementpost
    • [beta] Returns a list of all detections in an organization.get
    • [beta] Set an equipment digital output statepatch
    • [beta] Start a Function run.post
    • [beta] Stream voice agent session summariesget
    • [beta] Unarchive a qualification record.post
    • [beta] Unassign an asset assignment.post
    • [beta] Update Safety Eventspatch
    • [beta] Update a Function.patch
    • [beta] Update a Functions storage file.put
    • [beta] Update a partpatch
    • [beta] Update a part inventory locationpatch
    • [beta] Update a placepatch
    • [beta] Update a preferred fuel station.patch
    • [beta] Update a qualification record.patch
    • [beta] Update a ridership passenger.put
    • [beta] Update a ridership route setup.put
    • [beta] Update a route templatepatch
    • [beta] Update a watchpointpatch
    • [beta] Update an equipmentpatch
    • [beta] Update engine immobilizer state of a vehicle.patch
    • [beta] Update the shippingDocs field of an existing assignment.patch
    • [beta] Voice sign-in: resolve driver and create assignmentpost
  • Preview APIs
    • [beta] Complete a fleet installer photo upload.post
    • [beta] Create a fleet installer photo upload.post
    • [beta] Create a purchase orderpost
    • [beta] Create a tachograph file upload.post
    • [beta] Delete a purchase orderdel
    • [beta] List fleet installer photo uploads.get
    • [beta] List missing device recovery assets.get
    • [beta] List part transactionsget
    • [beta] List purchase ordersget
    • [beta] Mark an asset as missing.post
    • [beta] Mark an asset as recovered.post
    • [beta] Pair gateways to devicespost
    • [beta] Resolve a preventive maintenance instancepost
    • [beta] Update a purchase orderpatch
    • [beta] Update an upcoming preventive maintenance instancepatch
    • [preview] Create auth token for a driverpost
    • [preview] Delete an orderdel
    • [preview] Get order deletionsget
    • [preview] Get ordersget
    • [preview] Lock a vehicle.put
    • [preview] Stream ordersget
    • [preview] Unlock a vehicle.del
    • [preview] Upsert orderspost

Legacy

  • Industrial
    • List all assetsget
    • Create an assetpost
    • Delete an existing assetdel
    • Update an assetpatch
    • Writes to data outputs on an assetpatch
    • List all data inputsget
    • List most recent data points for data inputsget
    • Follow a real-time feed of data points for data inputsget
    • List historical data points for data inputsget
    • Fetch industrial camerasget
    • Fetch industrial camera programsget
    • Fetch the latest run for a camera or programget
    • Fetch runsget
    • [beta] Deletes an existing jobdel
    • Fetch runs by cameraget
    • [beta] Fetches all jobsget
    • Fetch runs by camera and programget
    • [beta] Patches a jobpatch
    • Get machine historypost
    • [beta] Create a jobpost
    • Get machinespost
  • Legacy APIs
    • [beta] List driver efficiencyget
    • [legacy] Get all defectsget
    • [legacy] Get all vehicles assigned to a set of driversget
    • [legacy] Get all DVIRsget
    • [legacy] Get all drivers assigned to a set of vehiclesget
    • Delete a routedel

Issues

Updated 6 days ago


List historical locations for a given asset
Fleet
Did this page help you?

Updated 6 days ago


List historical locations for a given asset
Fleet
Did this page help you?