Vehicle data

Hyundai Santa Fe vehicle data API: signals, model years and connection options

Get API keys →

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)

SignalDIMO nameUnit
OdometerpowertrainTransmissionTravelledDistancekm
Fuel PercentagepowertrainFuelSystemRelativeLevel%
Current Charge LevelpowertrainTractionBatteryStateOfChargeCurrent%
Vehicle Speedspeedkm/h
Vehicle Ignition StatusisIgnitionOn—
Engine RPMpowertrainCombustionEngineSpeedrpm
Coolant TemperaturepowertrainCombustionEngineECT°C
Air TemperatureexteriorAirTemperature°C
Back Left WheelchassisAxleRow2WheelLeftTirePressurekPa
Back Right WheelchassisAxleRow2WheelRightTirePressurekPa
Distance with MIL OnobdDistanceWithMILkm
DTC CountobdStatusDTCCount—
Engine runtimeobdRunTimeseconds
Front Left WheelchassisAxleRow1WheelLeftTirePressurekPa
Front Right WheelchassisAxleRow1WheelRightTirePressurekPa
Fuel LevelpowertrainFuelSystemAbsoluteLevelliters
Fuel TypeobdFuelTypeName—
Low Voltage BatterylowVoltageBatteryCurrentVoltagevolts
OBD Device Plugged InobdIsPluggedIn—
Powertrain TypepowertrainType—
Throttle PositionpowertrainCombustionEngineTPS%
Altitude LevelcurrentLocationAltitudem
CoordinatescurrentLocationCoordinates—
HeadingcurrentLocationHeadingdegrees

DIMO device — AutoPi (2012 and newer)

SignalDIMO nameUnit
OdometerpowertrainTransmissionTravelledDistancekm
Fuel PercentagepowertrainFuelSystemRelativeLevel%
Vehicle Speedspeedkm/h
Engine RPMpowertrainCombustionEngineSpeedrpm
Coolant TemperaturepowertrainCombustionEngineECT°C
Air TemperatureexteriorAirTemperature°C
Barometric PressureobdBarometricPressurekPa
Commanded EGRobdCommandedEGR%
Diagnostic Trouble CodesobdDTCList—
Distance Since DTC ClearobdDistanceSinceDTCClearkm
Distance with MIL OnobdDistanceWithMILkm
Engine Air IntakepowertrainCombustionEngineMAFgrams/second
Engine LoadobdEngineLoad%
Engine runtimeobdRunTimeseconds
Intake temperatureobdIntakeTemp°C
Long Term Fuel Trim (Bank 1)obdLongTermFuelTrim1%
Low Voltage BatterylowVoltageBatteryCurrentVoltagevolts
Manifold Absolute PressureobdMAPkPa
Short Term Fuel Trim (Bank 1)obdShortTermFuelTrim1%
Throttle PositionpowertrainCombustionEngineTPS%
Warmups Since DTC ClearobdWarmupsSinceDTCClear—
Altitude LevelcurrentLocationAltitudem
CoordinatescurrentLocationCoordinates—

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 signals
const 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 .