DIMO gives developers API access to Hyundai Santa Fe vehicle data. Model years 2012 and newer connect with a DIMO device (DIMO LTE R1 or AutoPi). Headline signals include odometer, fuel percentage and current charge level.
DIMO gives developers API access to vehicle-state data: diagnostics, fault codes, battery and fuel health, odometer, and maintenance signals. The Hyundai Santa Fe in the record is an ICE model that connects through a DIMO device, with coverage for 2012 and newer model years, and that coverage has been tested. Vehicle owners consent to and control sharing, so builders get data with clear provenance. You read the data through the Telemetry API, which is a GraphQL API, using a Vehicle JWT.
Signals by connection type
DIMO device — DIMO LTE R1 (2013 and newer)
| Signal | DIMO name | Unit |
|---|---|---|
| Odometer | powertrainTransmissionTravelledDistance | km |
| Fuel Percentage | powertrainFuelSystemRelativeLevel | % |
| Current Charge Level | powertrainTractionBatteryStateOfChargeCurrent | % |
| Vehicle Speed | speed | km/h |
| Vehicle Ignition Status | isIgnitionOn | — |
| Engine RPM | powertrainCombustionEngineSpeed | rpm |
| Coolant Temperature | powertrainCombustionEngineECT | °C |
| Air Temperature | exteriorAirTemperature | °C |
| Back Left Wheel | chassisAxleRow2WheelLeftTirePressure | kPa |
| Back Right Wheel | chassisAxleRow2WheelRightTirePressure | kPa |
| Distance with MIL On | obdDistanceWithMIL | km |
| DTC Count | obdStatusDTCCount | — |
| Engine runtime | obdRunTime | seconds |
| Front Left Wheel | chassisAxleRow1WheelLeftTirePressure | kPa |
| Front Right Wheel | chassisAxleRow1WheelRightTirePressure | kPa |
| Fuel Level | powertrainFuelSystemAbsoluteLevel | liters |
| Fuel Type | obdFuelTypeName | — |
| Low Voltage Battery | lowVoltageBatteryCurrentVoltage | volts |
| OBD Device Plugged In | obdIsPluggedIn | — |
| Powertrain Type | powertrainType | — |
| Throttle Position | powertrainCombustionEngineTPS | % |
| Altitude Level | currentLocationAltitude | m |
| Coordinates | currentLocationCoordinates | — |
| Heading | currentLocationHeading | degrees |
DIMO device — AutoPi (2012 and newer)
| Signal | DIMO name | Unit |
|---|---|---|
| Odometer | powertrainTransmissionTravelledDistance | km |
| Fuel Percentage | powertrainFuelSystemRelativeLevel | % |
| Vehicle Speed | speed | km/h |
| Engine RPM | powertrainCombustionEngineSpeed | rpm |
| Coolant Temperature | powertrainCombustionEngineECT | °C |
| Air Temperature | exteriorAirTemperature | °C |
| Barometric Pressure | obdBarometricPressure | kPa |
| Commanded EGR | obdCommandedEGR | % |
| Diagnostic Trouble Codes | obdDTCList | — |
| Distance Since DTC Clear | obdDistanceSinceDTCClear | km |
| Distance with MIL On | obdDistanceWithMIL | km |
| Engine Air Intake | powertrainCombustionEngineMAF | grams/second |
| Engine Load | obdEngineLoad | % |
| Engine runtime | obdRunTime | seconds |
| Intake temperature | obdIntakeTemp | °C |
| Long Term Fuel Trim (Bank 1) | obdLongTermFuelTrim1 | % |
| Low Voltage Battery | lowVoltageBatteryCurrentVoltage | volts |
| Manifold Absolute Pressure | obdMAP | kPa |
| Short Term Fuel Trim (Bank 1) | obdShortTermFuelTrim1 | % |
| Throttle Position | powertrainCombustionEngineTPS | % |
| Warmups Since DTC Clear | obdWarmupsSinceDTCClear | — |
| Altitude Level | currentLocationAltitude | m |
| Coordinates | currentLocationCoordinates | — |
No factory connectivity?
Hyundai Santa Fe model years 2012 and newer have no OEM cloud connection listed. For these years, a DIMO device (DIMO LTE R1 or AutoPi) plugs into the OBD-II port and streams vehicle signals once the owner connects it and consents to sharing.
See the developer quickstart for how owners connect vehicles and grant access.
Events available
- Idling
- Refuel
- Recharge
- Harsh braking
- New diagnostic trouble code
Build it
Query the latest Hyundai Santa Fe signals with the DIMO TypeScript SDK. The vehicle owner must first share access with your app through DIMO Connect.
import { DIMO } from '@dimo-network/data-sdk';
const dimo = new DIMO('Production');const tokenId = Number(process.env.DIMO_TOKEN_ID); // from DIMO Connect
const developerJwt = await dimo.auth.getDeveloperJwt({ client_id: process.env.DIMO_CLIENT_ID, domain: process.env.DIMO_REDIRECT_URI, private_key: process.env.DIMO_API_KEY,});const vehicleJwt = await dimo.tokenexchange.getVehicleJwt({ ...developerJwt, tokenId,});
// Latest Hyundai Santa Fe signalsconst data = await dimo.telemetry.query({ ...vehicleJwt, query: ` query { signalsLatest(tokenId: ${tokenId}) { powertrainTransmissionTravelledDistance { value timestamp } powertrainFuelSystemRelativeLevel { value timestamp } powertrainTractionBatteryStateOfChargeCurrent { value timestamp } } }`,});console.log(JSON.stringify(data, null, 2));Full walkthrough: Developer quickstart.
FAQ
Can I read fuel level remotely on a Hyundai Santa Fe?
Yes, with a DIMO device. Both listed devices report fuel percentage as powertrainFuelSystemRelativeLevel, and the DIMO LTE R1 also lists fuel level in liters. Query these signals through the Telemetry API with a Vehicle JWT.
How do I track a Hyundai Santa Fe with no connected services?
Install a DIMO device, which is the connection type listed for this vehicle. Once the owner shares the vehicle with your Developer License, exchange your Developer JWT for a Vehicle JWT through the Token Exchange API. Then query the Telemetry API for the vehicle's signals.
Can I get check-engine light alerts for a Hyundai Santa Fe?
The AutoPi device entry lists the dtc event, and it also lists the obdDTCList signal for diagnostic trouble codes. Use the Vehicle Triggers API (webhooks) to have DIMO push events to your targetURL when a condition you configured is met.
How do I detect idling on a Hyundai Santa Fe?
Both listed DIMO devices list the idling event. Query the Telemetry API segments resource with the idling mechanism, which requires a DIMO device. It defines idle as periods where engine RPM stays in the idle range, and the maxIdleRpm setting defaults to 1000.
How do I verify Hyundai Santa Fe mileage?
Both listed DIMO devices report the odometer signal. To get a verifiable record, call the Attestation API odometer-statement endpoint with a Vehicle JWT. You then retrieve the resulting credential through the Telemetry API.
Which Hyundai Santa Fe model years work with DIMO?
DIMO devices have been seen working on Hyundai Santa Fe model years 2012 and newer. For older vehicles, contact DIMO for additional support.
Do I need hardware to get Hyundai Santa Fe data?
Yes. DIMO lists no OEM cloud connection for the Hyundai Santa Fe, so data comes from a DIMO device.
Source: DIMO vehicle compatibility records. Coverage tested on a connected vehicle. Last verified .