Samsara

Methods (31)

• listAssets

  read

  List assets (vehicles/trailers/equipment). Filter by tagIds.

  Returns id, name, type, regulationMode, createdAtTime.

• listIndustrialAssets

  read

  List industrial assets (gateways/monitors/sensors).

  Returns id, name, isRunning, location, dataInputs, dataOutputs, tags.

• getIndustrialAsset

  read

  Get a single industrial asset by ID. Returns full detail including all data inputs and data outputs.

  Required paramsassetId

• getIndustrialDataPoints

  read

  Get time-series for an industrial data input. dataInputId from listIndustrialAssets.

  Required paramsdataInputIdstartTimeendTime

• listVehicles

  read

  List vehicles from the Samsara fleet. Returns id, name, vin, make, model, year, licensePlate, tags.

• getVehicleLocations

  read

  Snapshot GPS for all vehicles. Returns lat, lng, speed, heading, address, time.

• getVehicleLocationsFeed

  read

  Feed polling for vehicle locations. Pass endCursor as after on next calls.

• getVehicleLocationsHistory

  read

  Get historical vehicle locations within a time range (ISO 8601).

  Required paramsstartTimeendTime

• getVehicleStats

  read

  Snapshot vehicle stats. types required (max 3): gps, engineStates, fuelPercents, etc.

  Required paramstypes

• getVehicleStatsFeed

  read

  Feed polling for vehicle stats. Poll >=5s. Returns changes since last cursor.

  Required paramstypes

• getVehicleStatsHistory

  read

  Get historical vehicle stats within a time range.

  Required paramstypesstartTimeendTime

• getEquipmentStats

  read

  Get current equipment stats snapshot. Same stat types as vehicles.

  Required paramstypes

• getEquipmentStatsFeed

  read

  Feed-based polling for incremental equipment stat updates.

  Required paramstypes

• getEquipmentStatsHistory

  read

  Get historical equipment stats within a time range.

  Required paramstypesstartTimeendTime

• getEquipmentLocationsFeed

  read

  Feed-based polling for equipment location updates.

• listDrivers

  read

  List drivers (active by default).

  Returns id, name, username, timezone, eldSettings, carrierSettings.

• getDriver

  read

  Get a single driver by Samsara ID or external ID (e.g. tmsId:98765).

  Required paramsdriverId

• listAddresses

  read

  List addresses (geofences/yards).

  Returns id, name, formattedAddress, lat/lng, geofence shape, types.

• getAddress

  read

  Get a single address/geofence by ID.

  Required paramsaddressId

• listTags

  read

  List all tags. Tags organize vehicles, drivers, and assets hierarchically.

• listContacts

  read

  List contacts in the organization. Returns id, firstName, lastName, email, phone.

• listUsers

  read

  List users with their roles. Returns id, name, email, authType, roles.

• listTrips

  read

  List historical trip records. Requires startTime and endTime (ISO 8601).

  Required paramsstartTimeendTime

• getHosClocks

  read

  Current HOS clocks. Shows remaining drive/on-duty/cycle/break time.

• getHosLogs

  read

  Get HOS log entries within a time range.

  Required paramsstartTimeendTime

• getHosDailyLogs

  read

  Get daily HOS duty-status summaries. Uses date strings (YYYY-MM-DD).

  Required paramsstartDateendDate

• getHosViolations

  read

  Get HOS violations within a time range.

  Required paramsstartTimeendTime

• getSafetyEvents

  read

  Get safety events (harsh braking, acceleration, speeding, crashes) within a time range.

  Required paramsstartTimeendTime

• listDvirs

  read

  List DVIRs (driver vehicle inspections) in a time range. Needs proper API scope.

  Required paramsstartTimeendTime

• getDriverVehicleAssignments

  read

  Get driver-vehicle assignments within a time range. filterBy is required: "drivers" or "vehicles".

  Required paramsstartTimeendTimefilterBy

• querySamsara

  read

  Generic Samsara API helper for any endpoint not covered by dedicated functions.

  Required paramsendpoint