Vehicle Signals
Signals from DIMO-connected vehicles.
Overview
There are two types of query fields that you can use to retrieve vehicle signals from the Telemetry API, depending on if you’re looking for the latest signal data, or if you need to look up historical signal data from the past:
-
The
signalsquery allows you to retrieve signal data from a vehicle for a given time period. It is commonly used to perform look backs with a set interval within a time period for a vehicle. -
The
signalsLatestquery allows you to retrieve the most recent signal data from a vehicle. It returns the latest signals received from the respective data sources.
signals
The signals resource is an aggregation of detailed signal fields, used to retrieve vehicle signal data between a specified time period in the past.
Arguments
tokenIdInt!RequiredfromTime!RequiredtoTime!RequiredintervalString!RequiredfilterSignalFilterOptionalWhen using
signals, be sure to also include the relevant aggregation type.# Sample Telemetry Query
query GetHistoricalSignals{
signals(
tokenId: 12345
from: "2024-05-07T09:21:19Z"
to: "2024-05-10T09:21:19Z"
interval: "24h"
) {
timestamp
speed(agg: MAX)
}
}
signalsLatest
The signalsLatest resource is a SignalCollection that returns data for any signal that was most recently seen matching the filter.
Arguments
tokenIdInt!RequiredfilterSignalFilterOptionalWhen using
signalsLatest, be sure to include a value and optionally a timestamp.# Sample Telemetry Query
query GetLatestSignals{
signalsLatest(tokenId: 12345) {
powertrainTransmissionTravelledDistance {
value
}
powertrainFuelSystemRelativeLevel {
value
timestamp
}
}
}
Categories of Data
Keys
- Signal: The field name that can be queried for signals or signalsLatest.
- Common Name: A simplified, consumer-friendly naming convention for the signal.
- Aggregation (Agg.) Type: The Aggregation Type as specified for the signals resource.
- Units: The unit returned for the specific signal quieried, if relevant.
- Description: A longer description for the specific signal.
Signal Name
lastSeenCommon NameLast Seen
The last time any signal was seen matching the filter. Only available on
signalsLatestSignal Name
availableSignalsCommon NameAvailable Vehicle Signals
Returns a list of queryable signal names that have stored data for a given
tokenId.Signal Name
powertrainTransmissionTravelledDistanceCommon NameOdometer
Odometer reading in kilometers, total distance travelled during the lifetime of the transmission.
Signal Name
vinVCCommon NameVIN #
Returns the latest VINVC data for a given token. Note: This is a standalone query field, not a sub-field of
signals or signalsLatest. Query example: query { vinVCLatest(tokenId: 12345) { vin } }Signal Name
isIgnitionOnCommon NameVehicle Ignition Status
Vehicle ignition status.
True (1) = Vehicle Ignition On
False (0) = Vehicle Ignition Off
Signal Name
speedCommon NameVehicle Speed
The vehicle speed in km/hr
Signal Name
angularVelocityYawCommon NameYaw Rate
Vehicle rotation rate along the vertical (Z) axis.
Signal Name
connectivityCellularIsJammingDetectedCommon NameCellular Jamming Detection
Indicates whether cellular jamming has been detected.
True (1) = Jamming detected
False (0) = No jamming detected
Signal Name
bodyLightsIsAirbagWarningOnCommon NameAirbag Warning
Indicates whether the airbag/SRS warning telltale is active.
True (1) = Warning active
False (0) = Warning inactive
Signal Name
bodyLockIsLockedCommon NameCentral Lock Status
Central locking status of the vehicle.
True (1) = Locked
False (0) = Unlocked
Signal Name
bodyTrunkFrontIsOpenCommon NameFront Trunk / Frunk
Front trunk (frunk) open/closed status.
True (1) = Open
False (0) = Closed
Signal Name
bodyTrunkRearIsOpenCommon NameRear Trunk
Rear trunk open/closed status.
True (1) = Open
False (0) = Closed
Note that these signals require a user to have shared the relevant location privileges with your Developer License.
Signal Name
currentLocationCoordinatesCommon NameCoordinates
Current location of the vehicle in WGS 84 coordinates, as measured at the position of GNSS receiver antenna. Returns latitude, longitude, and HDOP.
Signal Name
currentLocationApproximateCoordinatesCommon NameApproximate Coordinates
Approximation of current location in WGS 84 coordinates (latitude, longitude, hdop).
Signal Name
currentLocationAltitudeCommon NameAltitude Level
Current altitude relative to WGS 84 reference ellipsoid, as measured at the position of GNSS receiver antenna.
Signal Name
currentLocationHeadingCommon NameHeading
Current heading of the vehicle in degrees (0–360), measured clockwise from true north.
Signal Name
powertrainTractionBatteryChargingChargeCurrentACCommon NameAC Current Charge (Alternating Current)
Current AC charging current (rms) at inlet. Negative if returning energy to grid. Used when per-phase numbers are unavailable.
Signal Name
powertrainTractionBatteryChargingChargeLimitCommon NameCharge Limit
Target charge limit (state of charge) for battery.
Signal Name
powertrainTractionBatteryChargingChargeVoltageUnknownTypeCommon NameCharging Voltage
Current charging voltage at inlet. Used when the data source does not indicate the current type (AC or DC) in use.
Signal Name
powertrainTractionBatteryChargingIsChargingCommon NameCharging Status
True if charging is ongoing. Charging is considered to be ongoing if energy is flowing from charger to vehicle.
True (1) - Vehicle is charging.
False (0) - Vehicle is not charging.
True (1) - Vehicle is charging.
False (0) - Vehicle is not charging.
Signal Name
powertrainTractionBatteryChargingIsChargingCableConnectedCommon NameCharging Cable Connected
Indicates whether a charging cable is connected to the vehicle.
True (1) = Cable connected
False (0) = Cable not connected
Signal Name
powertrainTractionBatteryChargingPowerCommon NameCharging Power
Current charging power delivered to the traction battery.
Signal Name
powertrainTractionBatteryCurrentPowerCommon NameBattery Power
Current electrical energy flowing in/out of battery. Positive = Energy flowing in to battery, e.g. during charging. Negative = Energy flowing out of battery, e.g. during driving.
Signal Name
powertrainTractionBatteryCurrentVoltageCommon NameBattery Voltage
Current voltage of the traction battery pack.
Signal Name
powertrainTractionBatteryGrossCapacityCommon NameTotal Battery Capacity
Gross capacity of the battery.
Signal Name
powertrainTractionBatteryRangeCommon NameBattery Range
Remaining range in km based on current battery state of charge.
Signal Name
powertrainTractionBatteryStateOfChargeCurrentCommon NameCurrent Charge Level
Physical state of charge of the high voltage battery, relative to net capacity. This is not necessarily the state of charge being displayed to the customer.
Signal Name
powertrainTractionBatteryStateOfChargeCurrentEnergyCommon NameRemaining Energy
Physical state of charge of the high voltage battery.
Signal Name
powertrainTractionBatteryStateOfHealthCommon NameBattery State of Health
Indicates the battery health as a percentage of the original rated capacity (0–100%).
Signal Name
powertrainTractionBatteryTemperatureAverageCommon NameBattery Temperature
Average temperature of the traction battery pack.
Signal Name
powertrainTractionBatteryChargingAddedEnergyCommon NameSession Energy
The amount of charge added to the battery during the current charging session.
Signal Name
lowVoltageBatteryCurrentVoltageCommon NameLow Voltage Battery
Current Voltage of the low voltage battery.
Signal Name
obdDTCListCommon NameDiagnostic Trouble Codes
List of currently active DTCs formatted according OBD II (SAE-J2012DA_201812) standard ([P|C|B|U]XXXXX )
Signal Name
obdStatusDTCCountCommon NameDTC Count
Number of currently active Diagnostic Trouble Codes.
Signal Name
obdRunTimeCommon NameEngine runtime
PID 1F - Engine run time.
Signal Name
obdIntakeTempCommon NameIntake temperature
PID 0F - Intake temperature.
Signal Name
obdEngineLoadCommon NameEngine Load
PID 04 - Engine load in percent - 0 = no load, 100 = full load.
Signal Name
obdBarometricPressureCommon NameBarometric Pressure
PID 33 - Barometric pressure.
Signal Name
obdMAPCommon NameManifold Absolute Pressure
PID 0B - Manifold absolute pressure.
Signal Name
obdFuelPressureCommon NameFuel Pressure
PID 0A - Fuel pressure.
Signal Name
obdFuelRateCommon NameFuel Rate
PID 5E - Engine fuel rate.
Signal Name
obdFuelTypeNameCommon NameFuel Type
PID 51 decoded - fuel type name (e.g. Gasoline, Diesel, Electric).
Signal Name
obdOilTemperatureCommon NameOil Temperature
PID 5C - Engine oil temperature.
Signal Name
obdCommandedEGRCommon NameCommanded EGR
PID 2C - Commanded Exhaust Gas Recirculation (EGR) percentage.
Signal Name
obdCommandedEVAPCommon NameCommanded EVAP Purge
PID 2E - Commanded evaporative purge percentage.
Signal Name
obdShortTermFuelTrim1Common NameShort Term Fuel Trim (Bank 1)
PID 06 - Short term fuel trim for bank 1.
Signal Name
obdLongTermFuelTrim1Common NameLong Term Fuel Trim (Bank 1)
PID 07 - Long term fuel trim for bank 1.
Signal Name
obdO2WRSensor1VoltageCommon NameO2 Sensor 1 Voltage
Wide-range oxygen sensor 1 voltage.
Signal Name
obdO2WRSensor2VoltageCommon NameO2 Sensor 2 Voltage
Wide-range oxygen sensor 2 voltage.
Signal Name
obdDistanceSinceDTCClearCommon NameDistance Since DTC Clear
PID 31 - Distance travelled since diagnostic trouble codes were last cleared.
Signal Name
obdDistanceWithMILCommon NameDistance with MIL On
PID 21 - Distance travelled with Malfunction Indicator Lamp (MIL) on.
Signal Name
obdWarmupsSinceDTCClearCommon NameWarmups Since DTC Clear
PID 30 - Number of warm-up cycles since diagnostic trouble codes were cleared.
Signal Name
obdIsEngineBlockedCommon NameEngine Blocked
Indicates whether the engine is blocked.
True (1) = Engine blocked
False (0) = Engine not blocked
Signal Name
obdIsPTOActiveCommon NamePTO Active
PID 1E - Indicates whether the Power Take-Off (PTO) is active.
True (1) = PTO active
False (0) = PTO inactive
True (1) = PTO active
False (0) = PTO inactive
Signal Name
obdIsPluggedInCommon NameOBD Device Plugged In
Indicates whether the aftermarket OBD device is plugged in.
True (1) = Plugged in
False (0) = Not plugged in
Signal Name
powertrainTypeCommon NamePowertrain Type
Defines the powertrain type of the vehicle.
Signal Name
powertrainRangeCommon NameRange (remaining)
Remaining range in km using all energy sources available in the vehicle.
Signal Name
powertrainCombustionEngineTPSCommon NameThrottle Position
Current throttle position.
Signal Name
powertrainCombustionEngineSpeedCommon NameEngine RPM
Engine speed measured as rotations per minute (rpm).
Signal Name
powertrainCombustionEngineMAFCommon NameEngine Air Intake
Grams of air drawn into engine per second.
Signal Name
powertrainCombustionEngineTorqueCommon NameEngine Torque
Current engine torque output.
Signal Name
powertrainCombustionEngineTorquePercentCommon NameEngine Torque Percent
Engine torque as a percentage of maximum torque.
Signal Name
powertrainCombustionEngineEngineOilLevelCommon NameOil Level
Engine oil level.
Signal Name
powertrainCombustionEngineEngineOilRelativeLevelCommon NameOil Level (Relative)
Engine oil level as a percentage of the recommended full level (0–100%).
Signal Name
powertrainCombustionEngineECTCommon NameCoolant Temperature
Engine coolant temperature.
Signal Name
powertrainCombustionEngineEOPCommon NameEngine Oil Pressure
Engine oil pressure.
Signal Name
powertrainCombustionEngineEOTCommon NameEngine Oil Temperature
Engine oil temperature.
Signal Name
powertrainCombustionEngineDieselExhaustFluidLevelCommon NameDEF Level
Diesel Exhaust Fluid (DEF/AdBlue) level as a percentage of tank capacity (0–100%).
Signal Name
powertrainCombustionEngineDieselExhaustFluidCapacityCommon NameDEF Tank Capacity
Total capacity of the Diesel Exhaust Fluid (DEF/AdBlue) tank.
Signal Name
powertrainTransmissionCurrentGearCommon NameCurrent Gear
The current engaged gear of the transmission. Negative values may indicate reverse.
Signal Name
powertrainTransmissionSelectedGearCommon NameSelected Gear
The gear selected by the driver (e.g. via shifter position).
Signal Name
powertrainTransmissionTemperatureCommon NameTransmission Temperature
Current temperature of the transmission fluid.
Signal Name
powertrainTransmissionIsClutchSwitchOperatedCommon NameClutch Switch
Indicates whether the clutch switch is currently operated (pressed).
True (1) = Clutch pressed
False (0) = Clutch released
Signal Name
powertrainTransmissionRetarderActualTorqueCommon NameRetarder Torque
Actual torque of the transmission retarder as a percentage of maximum.
Signal Name
powertrainTransmissionRetarderTorqueModeCommon NameRetarder Torque Mode
The active torque mode of the transmission retarder.
Signal Name
exteriorAirTemperatureCommon NameAir Temperature
Air temperature outside the vehicle.
Signal Name
powertrainFuelSystemSupportedFuelTypesCommon NameSupported Fuel Types
High level information of fuel types supported.
Signal Name
powertrainFuelSystemRelativeLevelCommon NameFuel Percentage
Current available fuel in the fuel tank in %, from 0 to 100.
Signal Name
powertrainFuelSystemAbsoluteLevelCommon NameFuel Level
Current available fuel in the fuel tank expressed in liters.
Signal Name
powertrainFuelSystemAccumulatedConsumptionCommon NameAccumulated Fuel Consumption
Total accumulated fuel consumed over the lifetime of the vehicle.
Signal Name
chassisAxleRow1WheelLeftTirePressureCommon NameFront Left Wheel
Tire pressure of the front left tire in kilo-Pascal.
Signal Name
chassisAxleRow1WheelRightTirePressureCommon NameFront Right Wheel
Tire pressure of the front right tire in kilo-Pascal.
Signal Name
chassisAxleRow2WheelLeftTirePressureCommon NameBack Left Wheel
Tire pressure of the rear left tire in kilo-Pascal.
Signal Name
chassisAxleRow2WheelRightTirePressureCommon NameBack Right Wheel
Tire pressure of the rear right tire in kilo-Pascal.
Signal Name
chassisAxleRow1WheelLeftSpeedCommon NameFront Left Wheel Speed
Rotational speed of the front left wheel.
Signal Name
chassisAxleRow1WheelRightSpeedCommon NameFront Right Wheel Speed
Rotational speed of the front right wheel.
Signal Name
chassisAxleRow3WeightCommon NameAxle Row 3 Weight
Weight measured at axle row 3 (commercial/heavy vehicles).
Signal Name
chassisAxleRow4WeightCommon NameAxle Row 4 Weight
Weight measured at axle row 4 (commercial/heavy vehicles).
Signal Name
chassisAxleRow5WeightCommon NameAxle Row 5 Weight
Weight measured at axle row 5 (commercial/heavy vehicles).
Signal Name
chassisTireSystemIsWarningOnCommon NameTire Pressure Warning (TPMS)
Indicates whether the Tire Pressure Monitoring System (TPMS) warning is active.
True (1) = Warning active
False (0) = Warning inactive
Signal Name
chassisBrakeIsPedalPressedCommon NameBrake Pedal Pressed
Indicates whether the brake pedal is currently pressed.
True (1) = Pedal pressed
False (0) = Pedal released
Signal Name
chassisBrakePedalPositionCommon NameBrake Pedal Position
Brake pedal position as a percentage of maximum travel (0–100%).
Signal Name
chassisParkingBrakeIsEngagedCommon NameParking Brake
Indicates whether the parking brake is engaged.
True (1) = Engaged
False (0) = Released
Signal Name
chassisBrakeABSIsWarningOnCommon NameABS Warning
Indicates whether the Anti-lock Braking System (ABS) warning telltale is active.
True (1) = Warning active
False (0) = Warning inactive
Signal Name
chassisBrakeCircuit1PressurePrimaryCommon NameBrake Circuit 1 Pressure
Primary pressure in brake circuit 1.
Signal Name
chassisBrakeCircuit2PressurePrimaryCommon NameBrake Circuit 2 Pressure
Primary pressure in brake circuit 2.
Signal Name
cabinSeatRow1DriverSideIsBeltedCommon NameFront Driver Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow1PassengerSideIsBeltedCommon NameFront Passenger Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow2DriverSideIsBeltedCommon NameRear Driver Side Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow2MiddleIsBeltedCommon NameRear Middle Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow2PassengerSideIsBeltedCommon NameRear Passenger Side Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow3DriverSideIsBeltedCommon NameThird Row Driver Side Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinSeatRow3PassengerSideIsBeltedCommon NameThird Row Passenger Side Seatbelt
True (1) = Seatbelt fastened.
False (0) = Seatbelt unfastened.
Signal Name
cabinDoorRow1DriverSideIsOpenCommon NameFront Driver Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1PassengerSideIsOpenCommon NameFront Passenger Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2DriverSideIsOpenCommon NameBack Driver Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2PassengerSideIsOpenCommon NameBack Passenger Side Door
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1DriverSideWindowIsOpenCommon NameFront Driver Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow1PassengerSideWindowIsOpenCommon NameFront Passenger Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2DriverSideWindowIsOpenCommon NameBack Driver Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
cabinDoorRow2PassengerSideWindowIsOpenCommon NameBack Passenger Side Window
True (1) = Fully or partially open.
False (0) = Fully closed.
Signal Name
serviceDistanceToServiceCommon NameDistance to Service
Distance remaining until the next scheduled vehicle service.
Signal Name
serviceTimeToServiceCommon NameTime to Service
Time remaining until the next scheduled vehicle service.
Advanced Filtering
currentLocationCoordinates Filters
This is an advanced filter that you can apply on the currentLocationCoordinates field under signals.
It is used to filter by a user-defined geofence that can be set using circles or polygons:
In Circle Filtering
Loading map components...
Map will load on client-side...