--- title: "Stats snapshot" method: GET path: "/fleet/vehicles/stats" tags: ["Vehicle Stats"] --- # Stats snapshot `GET /fleet/vehicles/stats` ## Request - Base URL: `https://api.samsara.com` - URL: `https://api.samsara.com/fleet/vehicles/stats` - Auth: HTTP bearer Returns the last known stats of all vehicles at the given `time`. If no `time` is specified, the current time is used. Related guide: Telematics. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicles category when creating or editing an API token. Learn More. ## Query parameters - `after` string - `time` string - `parentTagIds` string[] - `tagIds` string[] - `vehicleIds` string[] - `types` string[], required ## Response `200` Vehicle stats snapshot - VehicleStatsResponse: Vehicle stats snapshot and pagination info. - `data` VehicleStatsResponseData[], required: List of vehicles and a snapshot of the request stats. - `ambientAirTemperatureMilliC` VehicleStatsAmbientAirTempMilliC: Vehicle ambient air temperature reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The ambient air temperature reading in millidegree Celsius. - `auxInput1` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput10` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput11` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput12` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput13` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput2` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput3` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput4` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput5` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput6` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput7` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput8` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `auxInput9` VehicleStatsAuxInput: Data for auxiliary digio equipment. - `name` string: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `time` string: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` boolean: Boolean indicating the state of the auxiliary equipment. - `barometricPressurePa` VehicleStatsBarometricPressurePa: Vehicle barometric pressure reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The barometric pressure reading in pascals. - `batteryMilliVolts` VehicleStatsBatteryVoltage: Vehicle battery voltage reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The battery voltage in millivolts. - `defLevelMilliPercent` VehicleStatsDefLevelMilliPercent: The Diesel Exhaust Fluid (DEF) milli percentage reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The Diesel Exhaust Fluid (DEF) level in milli percentage points (e.g. `99001`, `49999`, etc). - `ecuDoorStatus` VehicleStatsResponseEcuDoorStatus: Door status as read from the vehicle (either from ECU or AUX as a fallback). - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Closed' | 'Open' | 'Unknown', required: Status of doors. Either `Closed`, `Open` or `Unknown`. - `ecuSpeedMph` VehicleStatsEcuSpeedMph: The speed of the vehicle in miles per hour, as reported by the ECU. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` number, double, required: The speed of the vehicle in miles per hour. - `engineCoolantTemperatureMilliC` VehicleStatsEngineCoolantTempMilliC: Vehicle engine coolant temperature reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The engine coolant temperature reading in millidegree Celsius. - `engineImmobilizer` VehicleStatsEngineImmobilizer: Data for the engine immobilizer - `connected` boolean, required: Whether the engine immobilizer is connected or not - `state` 'ignition_disabled' | 'ignition_enabled', required: The state of the engine immobilizer. Valid values: `ignition_disabled`, `ignition_enabled`. This stat type will only return states of our first Engine Immobilizer Hardware (ACC-EI). Please use Get engine immobilizer states to get states for both Engine Immobilizer Hardware versions (incl. HW-EI21). - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `engineLoadPercent` VehicleStatsEngineLoadPercent: The engine load percentage reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The engine load in percentage points (e.g. `99`, `50`, etc). - `engineOilPressureKPa` VehicleStatsEngineOilPressureKPa: Vehicle engine oil pressure reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The engine oil pressure reading in kilopascals. - `engineRpm` VehicleStatsEngineRpm: Vehicle engine RPM reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The revolutions per minute of the engine. - `engineState` VehicleStatsEngineState: Vehicle engine state event. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Off' | 'On' | 'Idle', required: The state of the engine. - `evAverageBatteryTemperatureMilliCelsius` VehicleStatsResponseEvAverageBatteryTemperatureMilliCelsius: Battery temperature for electric and hybrid vehicles in milli celsius. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery temperature for electric and hybrid vehicles in milli celsius. - `evBatteryCurrentMilliAmp` VehicleStatsResponseEvBatteryCurrentMilliAmp: Battery current for electric and hybrid vehicles in milli amps. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery current for electric and hybrid vehicles in milli amps. - `evBatteryStateOfHealthMilliPercent` VehicleStatsResponseEvBatteryStateOfHealthMilliPercent: Milli percent battery state of health for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Milli percent battery state of health for electric and hybrid vehicles. - `evBatteryVoltageMilliVolt` VehicleStatsResponseEvBatteryVoltageMilliVolt: Battery voltage for electric and hybrid vehicles in milli volts. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery voltage for electric and hybrid vehicles in milli volts. - `evChargingCurrentMilliAmp` VehicleStatsResponseEvChargingCurrentMilliAmp: Charging current for electric and hybrid vehicles in milli amps. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging current for electric and hybrid vehicles in milli amps. - `evChargingEnergyMicroWh` VehicleStatsResponseEvChargingEnergyMicroWh: Charging energy for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging energy for electric and hybrid vehicles in microwatt hours. - `evChargingStatus` VehicleStatsResponseEvChargingStatus: Charging status for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 0 | 1 | 2 | 3 | 4, required: Charging status for electric and hybrid vehicles. Statuses: unknown - 0, not charging - 1, charging - 2. - `evChargingVoltageMilliVolt` VehicleStatsResponseEvChargingVoltageMilliVolt: Charging voltage for electric and hybrid vehicles in milli volts. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging voltage for electric and hybrid vehicles in milli volts. - `evConsumedEnergyMicroWh` VehicleStatsResponseEvConsumedEnergyMicroWh: Consumed energy (including regenerated) for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Consumed energy (including regenerated) for electric and hybrid vehicles in microwatt hours. - `evDistanceDrivenMeters` VehicleStatsResponseEvDistanceDrivenMeters: Electric distance driven for electric and hybrid vehicles in meters. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Electric distance driven for electric and hybrid vehicles in meters. - `evRegeneratedEnergyMicroWh` VehicleStatsResponseEvRegeneratedEnergyMicroWh: Regenerated energy for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Regenerated energy for electric and hybrid vehicles in microwatt hours. - `evStateOfChargeMilliPercent` VehicleStatsResponseEvStateOfChargeMilliPercent: State of Charge for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Milli percent State of Charge for electric and hybrid vehicles. - `externalIds` VehicleExternalIds: The external IDs for the given object. - `faultCodes` VehicleStatsFaultCodes: Engine fault codes read from J1939, OBDII, and OEM vehicles. - `canBusType` string: The CAN bus type of the vehicle. - `j1939` VehicleStatsFaultCodesJ1939: Vehicle fault codes for J1939 vehicles. - `checkEngineLights` VehicleStatsFaultCodesJ1939Lights: Status of engine lights on J1939 vehicles. - `emissionsIsOn` boolean, required: True if the MIL status is nonzero. - `protectIsOn` boolean, required: True if the engine protect lamp status is nonzero. - `stopIsOn` boolean, required: True if the red lamp status is nonzero. - `warningIsOn` boolean, required: True if the amber lamp status is nonzero. - `diagnosticTroubleCodes` VehicleStatsFaultCodesJ1939TroubleCode[]: Diagnostic trouble codes for J1939 vehicles. - `fmiDescription` string: A short description of the FMI identifier, if available. - `fmiId` integer, required: The FMI identifier. - `milStatus` integer, required: The MIL status, indicating a check engine light. - `occurrenceCount` integer, required: The number of times this fault has triggered. - `sourceAddressName` string: The source address name corresponding to the txId - `spnDescription` string: A short description of the SPN identifier, if available. - `spnId` integer, required: The SPN identifier. - `txId` integer, required: The TX identifier. - `vendorSpecificFields` VehicleStatsFaultCodesVendorSpecificFields: Vendor specific data for J1939 vehicles. - `dtcDescription` string: The DTC description, if available. - `repairInstructionsUrl` string: A link to vendor repair instructions, if available. - `obdii` VehicleStatsFaultCodesOBDII: Vehicle fault codes for passenger vehicles. - `checkEngineLightIsOn` boolean: True if the check engine light is illuminated (MIL status field is nonzero for any faults). - `diagnosticTroubleCodes` VehicleStatsFaultCodesOBDIITroubleCode[]: Diagnostic trouble codes for passenger vehicles. - `confirmedDtcs` VehicleStatsFaultCodesPassengerDtc[]: Confirmed DTC codes. - `dtcDescription` string: The DTC description, if available. - `dtcId` integer, required: The DTC identifier. - `dtcShortCode` string: The DTC short code, if available. - `ignitionType` 'spark' | 'compression': The ignition type of this passenger vehicle. Valid values: `spark`, `compression`. - `milStatus` boolean: The MIL status, indicating a check engine light. - `monitorStatus` VehicleStatsFaultCodesPassengerMonitorStatus: Readings from engine sensors - `catalyst` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `comprehensive` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `egr` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `evapSystem` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `fuel` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `heatedCatalyst` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `heatedO2Sensor` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `isoSaeReserved` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `misfire` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `notReadyCount` integer: Count of the number of sensors reporting N: Not Complete - `o2Sensor` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `secondaryAir` 'N' | 'R' | 'U': Enum of monitor status: -U: Unsupported -N: Not Complete -R: Complete - `pendingDtcs` VehicleStatsFaultCodesPassengerDtc[]: Pending DTC codes. - `dtcDescription` string: The DTC description, if available. - `dtcId` integer, required: The DTC identifier. - `dtcShortCode` string: The DTC short code, if available. - `permanentDtcs` VehicleStatsFaultCodesPassengerDtc[]: Permanent DTC codes. - `dtcDescription` string: The DTC description, if available. - `dtcId` integer, required: The DTC identifier. - `dtcShortCode` string: The DTC short code, if available. - `txId` integer, required: The TX identifier. - `oem` VehicleStatsFaultCodesOem: Vehicle fault codes for OEM vehicles. - `diagnosticTroubleCodes` VehicleStatsFaultCodesOemTroubleCode[]: Proprietary diagnostic trouble codes for OEM vehicles. - `codeDescription` string: The OEM code description. - `codeIdentifier` string: The OEM code identifier. - `codeSeverity` string: The OEM code severity. - `codeSource` string: The OEM code source. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `fuelConsumedMilliliters` VehicleStatsFuelConsumedMilliliters: The cumulative fuel consumption in milliliters for vehicles. Cumulative values always increase. This includes all fuel consumption reported by vehicles without filtering of invalid data points. For filtered fuel consumption that matches the Fuel & Energy Report, please use the Fuel and Energy API. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The cumulative fuel consumption in milliliters for vehicles. Cumulative values always increase. This includes all fuel consumption reported by vehicles without filtering of invalid data points. For filtered fuel consumption that matches the Fuel & Energy Report, please use the Fuel and Energy API. - `fuelPercent` VehicleStatsFuelPercent: Vehicle fuel percentage reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The engine fuel level in percentage points (e.g. `99`, `50`, etc). - `gps` VehicleStatsGps: GPS location data for the vehicle. - `address` VehicleLocationAddress: Address that the location is in. - `id` string: Id of the address. - `name` string: Name of address. - `headingDegrees` number, double: Heading of the vehicle in degrees. - `isEcuSpeed` boolean: True if the speed value is reported from the ECU. Speed value is reported from GPS otherwise. - `latitude` number, double, required: GPS latitude represented in degrees - `longitude` number, double, required: GPS longitude represented in degrees - `reverseGeo` ReverseGeo: Reverse geocoded information. - `formattedLocation` string: Formatted address of the reverse geocoding data. - `speedMilesPerHour` number, double: GPS speed of the vehicle in miles per hour. See `isEcuSpeed` to determine speed data source. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `gpsDistanceMeters` VehicleStatsGpsDistanceMeters: Vehicle GPS distance event. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` number, double, required: Number of meters the vehicle has traveled since the gateway was installed, based on GPS calculations. - `gpsOdometerMeters` VehicleStatsGpsOdometerMeters: Vehicle GPS odometer event. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Number of meters the vehicle has traveled according to the GPS calculations and the manually-specified odometer reading. - `id` string, required: The unique Samsara ID of the Vehicle. This is automatically generated when the Vehicle object is created. It cannot be changed. - `idlingDurationMilliseconds` VehicleStatsIdlingDurationMilliseconds: The cumulative idling duration in milliseconds. Cumulative values always increase. For filtering of idling duration please use the Idling Events API. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The cumulative idling duration in milliseconds. Cumulative values always increase. For filtering of idling duration please use the Idling Events API. - `intakeManifoldTemperatureMilliC` VehicleStatsIntakeManifoldTempMilliC: Vehicle intake manifold temperature reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: The intake manifold temperature reading in millidegree Celsius. - `name` string, required: The human-readable name of the Vehicle. This is set by a fleet administrator and will appear in both Samsara’s cloud dashboard as well as the Samsara Driver mobile app. **By default**, this name is the serial number of the Samsara Vehicle Gateway. It can be set or updated through the Samsara Dashboard or through the API at any time. - `nfcCardScan` VehicleStatsNfcCardScan: Data for the nfc card and the time that it was scanned. - `card` VehicleStatsNfcCardScanCard, required: The card that was scanned. - `id` string: The id code of the card that was scanned. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `obdEngineSeconds` VehicleStatsObdEngineSeconds: Vehicle OBD engine seconds reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Number of seconds the vehicle's engine has been on according to the on-board diagnostics. - `obdOdometerMeters` VehicleStatsObdOdometerMeters: Vehicle OBD odometer reading. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Number of meters the vehicle has traveled according to the on-board diagnostics. - `seatbeltDriver` VehicleStatsResponseSeatbeltDriver: Seatbelt Driver Status as read from the vehicle. `Buckled` or `Unbuckled`. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Buckled' | 'Unbuckled', required: Seatbelt Driver Status as read from the vehicle. `Buckled` or `Unbuckled`. - `spreaderActive` VehicleStatsResponseSpreaderActive: Whether vehicle is actively spreading any material. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Off' | 'On', required: Whether vehicle is actively spreading any material. - `spreaderAirTemp` VehicleStatsResponseSpreaderAirTemp: Air (ambient) temperature in milli celsius reading from material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Air (ambient) temperature in milli celsius reading from material spreader. - `spreaderBlastState` VehicleStatsResponseSpreaderBlastState: Whether vehicle is actively spreading material in ‘blast mode’. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'On' | 'Off', required: Whether vehicle is actively spreading material in ‘blast mode’. - `spreaderGranularName` VehicleStatsResponseSpreaderGranularName: Name of most recent type of granular material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of granular material spread, read from the material spreader. - `spreaderGranularRate` VehicleStatsResponseSpreaderGranularRate: Granular spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Granular spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderLiquidName` VehicleStatsResponseSpreaderLiquidName: Name of most recent type of liquid material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of liquid material spread, read from the material spreader. - `spreaderLiquidRate` VehicleStatsResponseSpreaderLiquidRate: Liquid spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Liquid spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderOnState` VehicleStatsResponseSpreaderOnState: Whether vehicle spreader is enabled. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'On' | 'Off', required: Whether vehicle spreader is enabled. - `spreaderPlowStatus` VehicleStatsResponseSpreaderPlowStatus: Snow plow status (`Up` or `Down`), as read from the material spreader. Note: this is separate from plow status defined via auxInput. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Up' | 'Down', required: Snow plow status, as read from the material spreader - `spreaderPrewetName` VehicleStatsResponseSpreaderPrewetName: Name of most recent type of prewet material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of prewet material spread, read from the material spreader. - `spreaderPrewetRate` VehicleStatsResponseSpreaderPrewetRate: Prewet spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Prewet spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderRoadTemp` VehicleStatsResponseSpreaderRoadTemp: Road temperature reading in milli celsius from material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Road temperature reading in milli celsius from material spreader. - `syntheticEngineSeconds` VehicleStatsSyntheticEngineSeconds: The cumulative number of seconds the engine has run estimated based on when the engine is running. Please note that this method requires the addition of a baseline to trigger accumulation. - `decorations` VehicleStatsDecorations: Optional decorations to the primary stat event. See [here](doc:decorations) for more details. The example shows the response if you were to submit `decorations=engineStates&obdEngineSeconds` to the query parameter: ```json "decorations":{ "engineStates": { "value": "Off" }, "obdEngineSeconds": { "value": 9723103 } } ``` - `ambientAirTemperatureMilliC` VehicleStatsDecorationsAmbientAirTemperatureMilliC - `value` integer, required: The ambient air temperature reading in millidegree Celsius. - `auxInput1` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput10` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput11` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput12` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput13` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput2` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput3` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput4` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput5` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput6` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput7` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput8` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `auxInput9` VehicleStatsAuxInputDecoration - `name` string, required: The type of auxiliary input configured for this Vehicle. Once configured, these inputs will generate dynamic, time-series data that will be available to view in the Samsara Dashboard. **By default**: empty. This can be set or updated through the Samsara Dashboard or the API at any time. Inputs 3-13 are only available on gateways with an attached aux expander. The value returned will match what is configured in the dashboard per vehicle. - `value` boolean, required: Boolean indicating the state of the auxiliary equipment. - `barometricPressurePa` VehicleStatsDecorationsBarometricPressurePa - `value` integer, required: The barometric pressure reading in pascals. - `batteryMilliVolts` VehicleStatsDecorationsBatteryMilliVolts - `value` integer, required: The battery voltage in millivolts. - `defLevelMilliPercent` VehicleStatsDecorationsDefLevelMilliPercent - `value` integer, required: The Diesel Exhaust Fluid (DEF) level in milli percentage points (e.g. `99001`, `49999`, etc). - `ecuDoorStatus` VehicleStatsEcuDoorStatus: Door status as read from the vehicle (either from ECU or AUX as a fallback). - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Closed' | 'Open' | 'Unknown', required: Status of doors. Either `Closed`, `Open` or `Unknown`. - `ecuSpeedMph` VehicleStatsDecorationsEcuSpeedMph - `value` number, double, required: The speed of the vehicle in miles per hour, as reported by the ECU. - `engineCoolantTemperatureMilliC` VehicleStatsDecorationsEngineCoolantTemperatureMilliC - `value` integer, required: The engine coolant temperature reading in millidegree Celsius. - `engineImmobilizer` VehicleStatsEngineImmobilizer: Data for the engine immobilizer - `connected` boolean, required: Whether the engine immobilizer is connected or not - `state` 'ignition_disabled' | 'ignition_enabled', required: The state of the engine immobilizer. Valid values: `ignition_disabled`, `ignition_enabled`. This stat type will only return states of our first Engine Immobilizer Hardware (ACC-EI). Please use Get engine immobilizer states to get states for both Engine Immobilizer Hardware versions (incl. HW-EI21). - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `engineLoadPercent` VehicleStatsDecorationsEngineLoadPercent - `value` integer, required: The engine load in percentage points (e.g. `99`, `50`, etc). - `engineOilPressureKPa` VehicleStatsDecorationsEngineOilPressureKPa - `value` integer, required: The engine oil pressure reading in kilopascals. - `engineRpm` VehicleStatsDecorationsEngineRpm - `value` integer, required: The revolutions per minute of the engine. - `engineStates` VehicleStatsDecorationsEngineStates - `value` 'Off' | 'On' | 'Idle', required: The state of the engine. - `evAverageBatteryTemperatureMilliCelsius` VehicleStatsEvAverageBatteryTemperatureMilliCelsius: Battery temperature for electric and hybrid vehicles in milli celsius. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery temperature for electric and hybrid vehicles in milli celsius. - `evBatteryCurrentMilliAmp` VehicleStatsEvBatteryCurrentMilliAmp: Battery current for electric and hybrid vehicles in milli amps. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery current for electric and hybrid vehicles in milli amps. - `evBatteryStateOfHealthMilliPercent` VehicleStatsEvBatteryStateOfHealthMilliPercent: Milli percent battery state of health for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Milli percent battery state of health for electric and hybrid vehicles. - `evBatteryVoltageMilliVolt` VehicleStatsEvBatteryVoltageMilliVolt: Battery voltage for electric and hybrid vehicles in milli volts. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Battery voltage for electric and hybrid vehicles in milli volts. - `evChargingCurrentMilliAmp` VehicleStatsEvChargingCurrentMilliAmp: Charging current for electric and hybrid vehicles in milli amps. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging current for electric and hybrid vehicles in milli amps. - `evChargingEnergyMicroWh` VehicleStatsEvChargingEnergyMicroWh: Charging energy for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging energy for electric and hybrid vehicles in microwatt hours. - `evChargingStatus` VehicleStatsEvChargingStatus: Charging status for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 0 | 1 | 2 | 3 | 4, required: Charging status for electric and hybrid vehicles. Statuses: unknown - 0, not charging - 1, charging - 2. - `evChargingVoltageMilliVolt` VehicleStatsEvChargingVoltageMilliVolt: Charging voltage for electric and hybrid vehicles in milli volts. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Charging voltage for electric and hybrid vehicles in milli volts. - `evConsumedEnergyMicroWh` VehicleStatsEvConsumedEnergyMicroWh: Consumed energy (including regenerated) for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Consumed energy (including regenerated) for electric and hybrid vehicles in microwatt hours. - `evDistanceDrivenMeters` VehicleStatsEvDistanceDrivenMeters: Electric distance driven for electric and hybrid vehicles in meters. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Electric distance driven for electric and hybrid vehicles in meters. - `evRegeneratedEnergyMicroWh` VehicleStatsEvRegeneratedEnergyMicroWh: Regenerated energy for electric and hybrid vehicles in microwatt hours. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Regenerated energy for electric and hybrid vehicles in microwatt hours. - `evStateOfChargeMilliPercent` VehicleStatsEvStateOfChargeMilliPercent: State of Charge for electric and hybrid vehicles. Not all EV and HEVs may report this field. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Milli percent State of Charge for electric and hybrid vehicles. - `faultCodes` VehicleStatsFaultCodesValue: Fault codes for the vehicle - `canBusType` string: The CAN bus type of the vehicle. - `j1939` VehicleStatsFaultCodesValueJ1939: Vehicle fault codes for J1939 vehicles. - `checkEngineLights` VehicleStatsFaultCodesValueJ1939CheckEngineLights: Status of engine lights on J1939 vehicles. - … - `diagnosticTroubleCodes` VehicleStatsFaultCodesValueJ1939DiagnosticTroubleCodes[]: Diagnostic trouble codes for J1939 vehicles. - … - `obdii` VehicleStatsFaultCodesValueObdii: Vehicle fault codes for passenger vehicles. - `checkEngineLightIsOn` boolean: True if the check engine light is illuminated (MIL status field is nonzero for any faults). - `diagnosticTroubleCodes` VehicleStatsFaultCodesValueObdiiDiagnosticTroubleCodes[]: Diagnostic trouble codes for passenger vehicles. - … - `oem` VehicleStatsFaultCodesValueOem: Vehicle fault codes for OEM vehicles. - `diagnosticTroubleCodes` VehicleStatsFaultCodesValueOemDiagnosticTroubleCodes[]: Proprietary diagnostic trouble codes for OEM vehicles. - … - `fuelConsumedMilliliters` VehicleStatsDecorationsFuelConsumedMilliliters - `value` integer, required: The cumulative fuel consumption in milliliters for vehicles. Cumulative values always increase. This includes all fuel consumption reported by vehicles without filtering of invalid data points. For filtered fuel consumption that matches the Fuel & Energy Report, please use the Fuel and Energy API. - `fuelPercents` VehicleStatsDecorationsFuelPercents - `value` integer, required: The engine fuel level in percentage points (e.g. `99`, `50`, etc). - `gps` VehicleStatsDecorationsGps - `address` VehicleLocationAddress: Address that the location is in. - `id` string: Id of the address. - `name` string: Name of address. - `headingDegrees` number, double: Heading of the vehicle in degrees. - `isEcuSpeed` boolean: True if the speed value is reported from the ECU. Speed value is reported from GPS otherwise. - `latitude` number, double, required: GPS latitude represented in degrees - `longitude` number, double, required: GPS longitude represented in degrees - `reverseGeo` ReverseGeo: Reverse geocoded information. - `formattedLocation` string: Formatted address of the reverse geocoding data. - `speedMilesPerHour` number, double: GPS speed of the vehicle in miles per hour. See `isEcuSpeed` to determine speed data source. - `gpsDistanceMeters` VehicleStatsDecorationsGpsDistanceMeters - `value` number, double, required: Number of meters the vehicle has traveled since the gateway was installed, based on GPS calculations. - `gpsOdometerMeters` VehicleStatsDecorationsGpsOdometerMeters - `value` integer, required: Number of meters the vehicle has traveled according to the GPS calculations and the manually-specified odometer reading. - `idlingDurationMilliseconds` VehicleStatsDecorationsIdlingDurationMilliseconds - `value` integer, required: The cumulative idling duration in milliseconds. Cumulative values always increase. For filtering of idling duration please use the Idling Events API. - `intakeManifoldTemperatureMilliC` VehicleStatsDecorationsIntakeManifoldTemperatureMilliC - `value` integer, required: The intake manifold temperature reading in millidegree Celsius. - `obdEngineSeconds` VehicleStatsDecorationsObdEngineSeconds - `value` integer, required: Number of seconds the vehicle's engine has been on according to the on-board diagnostics. - `obdOdometerMeters` VehicleStatsDecorationsObdOdometerMeters - `value` integer, required: Number of meters the vehicle has traveled according to the on-board diagnostics. - `seatbeltDriver` VehicleStatsSeatbeltDriver: Seatbelt Driver Status as read from the vehicle. `Buckled` or `Unbuckled`. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Buckled' | 'Unbuckled', required: Seatbelt Driver Status as read from the vehicle. `Buckled` or `Unbuckled`. - `spreaderActive` VehicleStatsSpreaderActive: Whether vehicle is actively spreading any material. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Off' | 'On', required: Whether vehicle is actively spreading any material. - `spreaderAirTemp` VehicleStatsSpreaderAirTemp: Air (ambient) temperature in milli celsius reading from material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Air (ambient) temperature in milli celsius reading from material spreader. - `spreaderBlastState` VehicleStatsSpreaderBlastState: Whether vehicle is actively spreading material in ‘blast mode’. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'On' | 'Off', required: Whether vehicle is actively spreading material in ‘blast mode’. - `spreaderGranularName` VehicleStatsSpreaderGranularName: Name of most recent type of granular material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of granular material spread, read from the material spreader. - `spreaderGranularRate` VehicleStatsSpreaderGranularRate: Granular spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Granular spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderLiquidName` VehicleStatsSpreaderLiquidName: Name of most recent type of liquid material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of liquid material spread, read from the material spreader. - `spreaderLiquidRate` VehicleStatsSpreaderLiquidRate: Liquid spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Liquid spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderOnState` VehicleStatsSpreaderOnState: Whether vehicle spreader is enabled. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'On' | 'Off', required: Whether vehicle spreader is enabled. - `spreaderPlowStatus` VehicleStatsSpreaderPlowStatus: Snow plow status (`Up` or `Down`), as read from the material spreader. Note: this is separate from plow status defined via auxInput. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` 'Up' | 'Down', required: Snow plow status, as read from the material spreader - `spreaderPrewetName` VehicleStatsSpreaderPrewetName: Name of most recent type of prewet material spread, read from the material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` string, required: Name of most recent type of prewet material spread, read from the material spreader. - `spreaderPrewetRate` VehicleStatsSpreaderPrewetRate: Prewet spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Prewet spread rate reading in milliliters per meter, read from the material spreader. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. Unfiltered live stats are supplied as-read from the Material Spreader unit. Readings do not consider total spread rate(s) over time or distance. - `spreaderRoadTemp` VehicleStatsSpreaderRoadTemp: Road temperature reading in milli celsius from material spreader. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Road temperature reading in milli celsius from material spreader. - `tirePressure` VehicleStatsTirePressures: Tire pressure readings for each of four tires in kilopascals. - `backLeftTirePressureKPa` integer: The tire pressure of the rear left tire as seen when standing behind the vehicle in kilopascals. - `backRightTirePressureKPa` integer: The tire pressure of the rear right tire as seen when standing behind the vehicle in kilopascals. - `frontLeftTirePressureKPa` integer: The tire pressure of the front left tire as seen when standing behind the vehicle in kilopascals. - `frontRightTirePressureKPa` integer: The tire pressure of the front right tire as seen when standing behind the vehicle in kilopascals. - `time` string, required: UTC timestamp in RFC 3339 format. Example: `2020-01-27T07:06:25Z`. - `value` integer, required: Stats for the number of seconds the vehicle's engine has been on, calculated based on a manually-specified engine seconds reading and the number of seconds the vehicle has been on according to the engine state changes reported to the vehicle gateway since that reading was set. This stat will not be present for any vehicle that does not have the engine seconds reading set. The engine seconds reading can be set from the UI on the vehicle details page. - `pagination` PaginationResponse, required: Pagination parameters. - `endCursor` string, string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view. - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor. ## Other responses - `default`: Error response --- [API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)