Vehicle data

Kia Soul vehicle data API: signals, model years and connection options

Get API keys →

DIMO gives developers API access to Kia Soul vehicle data. Model years 2011 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. For the Kia Soul, that data comes through a DIMO device, with tested coverage for model years 2011 and newer. The Soul is a combustion-engine (ICE) vehicle, and the record lists no other connection type. Once an owner shares the vehicle, you read it through the Telemetry API with a Vehicle JWT.

Signals by connection type

DIMO device — DIMO LTE R1 (2014 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
Diagnostic Trouble CodesobdDTCList—
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 (2011 and newer)

SignalDIMO nameUnit
OdometerpowertrainTransmissionTravelledDistancekm
Fuel PercentagepowertrainFuelSystemRelativeLevel%
Vehicle Speedspeedkm/h
Engine RPMpowertrainCombustionEngineSpeedrpm
Coolant TemperaturepowertrainCombustionEngineECT°C
Air TemperatureexteriorAirTemperature°C
Barometric PressureobdBarometricPressurekPa
Diagnostic Trouble CodesobdDTCList—
Distance Since DTC ClearobdDistanceSinceDTCClearkm
Distance with MIL OnobdDistanceWithMILkm
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?

Kia Soul model years 2011 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 Kia Soul 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 Kia Soul 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 Kia Soul?

Yes, with a DIMO device. Both listed devices report fuel percentage, and the DIMO LTE R1 also reports fuel level in liters. Read them through the Telemetry API GraphQL endpoint with a Vehicle JWT.

How do I track a Kia Soul with no connected services?

Connect a DIMO device. The record lists the DIMO LTE R1 and AutoPi for the Soul. After the owner shares the vehicle with your Developer License, you can pull trip data from the Telemetry API segments query, which covers up to 31 days per request.

Can I get check-engine light alerts for a Kia Soul?

Yes, the dtc event is listed for both DIMO devices, and the obdDTCList signal carries the diagnostic trouble codes. To be notified when a condition is met, use the Vehicle Triggers API (webhooks), which sends a POST request to your targetURL.

How do I detect idling on a Kia Soul?

The idling event is listed for both DIMO devices. Query the Telemetry API segments with the idling detection mechanism, which finds contiguous periods where engine RPM stays in the idle range and requires a DIMO device. The default maximum idle RPM is 1000, and you can change it with maxIdleRpm.

How do I verify Kia Soul mileage?

Odometer is listed for both DIMO devices. Call the Attestation API odometer-statement endpoint with a Vehicle JWT to generate a verifiable credential, then retrieve it through the Telemetry API.

Which Kia Soul model years work with DIMO?

DIMO devices have been seen working on Kia Soul model years 2011 and newer. For older vehicles, contact DIMO for additional support.

Do I need hardware to get Kia Soul data?

Yes. DIMO lists no OEM cloud connection for the Kia Soul, so data comes from a DIMO device.

Source: DIMO vehicle compatibility records. Coverage tested on a connected vehicle. Last verified .