Diagnostics

Auto API
Level 12
Last Updated
Level 12
Added In
Level 3
Identifier
0x00 0x33

This page specifies the Auto API protocol for Vehicle Status. Head over to the REST API, iOS SDK, Android SDK or Node.js SDK code reference pages for platform specifics.

Mileage

id: 0x01
name: mileage
name_cased: mileage
name_pretty: Mileage
deprecated:
  new_name: odometer
  reason: "'mileage' is an incorrect term for this"
type: unit.length
size: 10
description: The vehicle mileage (odometer)

Example

data_component: 120441024f8000000000
value:
  kilometers: 150000
description: Odometer is showing 150'000.0km

Engine oil temperature

id: 0x02
name: engine_oil_temperature
name_cased: engineOilTemperature
name_pretty: Engine oil temperature
type: unit.temperature
size: 10
description: Engine oil temperature

Example

data_component: "17014058e00000000000"
value:
  celsius: 99.5
description: Engine oil temperature is 99.5°C

Speed

id: 0x03
name: speed
name_cased: speed
name_pretty: Speed
type: unit.speed
size: 10
description: The vehicle speed

Example

data_component: "1601404e000000000000"
value:
  kilometers_per_hour: 60
description: Vehicle speed is 60.0km/h

Engine RPM

id: 0x04
name: engine_rpm
name_cased: engineRPM
name_pretty: Engine RPM
type: unit.angular_velocity
size: 10
description: Engine RPM (revolutions per minute)

Example

data_component: 030040a3880000000000
value:
  revolutions_per_minute: 2500
description: Engine RPM is 2500.0

Fuel level

id: 0x05
name: fuel_level
name_cased: fuelLevel
name_pretty: Fuel level
type: types.percentage
description: Fuel level percentage between 0.0-1.0

Example

data_component: 3feccccccccccccd
value: 0.9
description: Fuel level is at 90%

Estimated range

id: 0x06
name: estimated_range
name_cased: estimatedRange
name_pretty: Estimated range
type: unit.length
size: 10
description: Estimated range (with combustion engine)

Example

data_component: "12044070900000000000"
value:
  kilometers: 265
description: Estimated range is 256.0km

Washer fluid level

id: 0x09
name: washer_fluid_level
name_cased: washerFluidLevel
name_pretty: Washer fluid level
type: types.fluid_level

Example

data_component: "01"
value: filled
description: Washer fluid is filled

Battery voltage

id: 0x0b
name: battery_voltage
name_cased: batteryVoltage
name_pretty: Battery voltage
type: unit.electric_potential_difference
size: 10
description: Battery voltage

Example

data_component: 0a004028333333333333
value:
  volts: 12.1
description: Battery voltage is 12.1V

AdBlue level

id: 0x0c
name: adblue_level
name_cased: adBlueLevel
name_pretty: AdBlue level
type: types.percentage
description: AdBlue level percentage between 0.0-1.0

Example

data_component: 3feccccccccccccd
value: 0.9
description: AdBlue level is at 90%

Distance since reset

id: 0x0d
name: distance_since_reset
name_cased: distanceSinceReset
name_pretty: Distance since reset
type: unit.length
size: 10
description: The distance driven since reset

Example

data_component: "12044097706666666666"
value:
  kilometers: 1500.1
description: 1'500.1km driven since reset

Distance since start

id: 0x0e
name: distance_since_start
name_cased: distanceSinceStart
name_pretty: Distance since start
type: unit.length
size: 10
description: The distance driven since trip start

Example

data_component: 12044028cccccccccccd
value:
  kilometers: 12.4
description: 12.4km driven since the engine start

Fuel volume

id: 0x0f
name: fuel_volume
name_cased: fuelVolume
name_pretty: Fuel volume
type: unit.volume
size: 10
description: The fuel volume measured in liters

Example

data_component: 19024041c00000000000
value:
  liters: 35.5
description: 35.5L of fuel remaining

Anti-lock braking system (ABS)

id: 0x10
name: anti_lock_braking
name_cased: antiLockBraking
name_pretty: Anti-lock braking system (ABS)
type: types.active_state

Example

data_component: "01"
value: active
description: ABS is active

Engine coolant temperature

id: 0x11
name: engine_coolant_temperature
name_cased: engineCoolantTemperature
name_pretty: Engine coolant temperature
type: unit.temperature
size: 10
description: Engine coolant temperature

Example

data_component: "17014034000000000000"
value:
  celsius: 20
description: Engine coolant temperature is 20°C

Engine total operation hours

id: 0x12
name: engine_total_operating_hours
name_cased: engineTotalOperatingHours
name_pretty: Engine total operation hours
deprecated:
  new_name: engine_total_operating_time
  reason: removed the unit from the name
type: unit.duration
size: 10
description: The accumulated time of engine operation

Example

data_component: 0702409772999999999a
value:
  hours: 1500.65
description: The engine has operated 1'500.65h in total

Engine total fuel consumption

id: 0x13
name: engine_total_fuel_consumption
name_cased: engineTotalFuelConsumption
name_pretty: Engine total fuel consumption
type: unit.volume
size: 10
description: The accumulated lifespan fuel consumption

Example

data_component: 190240daf0c000000000
value:
  liters: 27587
description: The engine has consumend 27'587.0L of fuel over it's lifespan

Brake fluid level

id: 0x14
name: brake_fluid_level
name_cased: brakeFluidLevel
name_pretty: Brake fluid level
type: types.fluid_level

Example

data_component: "00"
value: low
description: Brake fluid is low

Engine torque

id: 0x15
name: engine_torque
name_cased: engineTorque
name_pretty: Engine torque
type: types.percentage
description: Current engine torque percentage between 0.0-1.0

Example

data_component: 3fc999999999999a
value: 0.2
description: Engine torque is currently at 20%

Engine load

id: 0x16
name: engine_load
name_cased: engineLoad
name_pretty: Engine load
type: types.percentage
description: Current engine load percentage between 0.0-1.0

Example

data_component: 3fb999999999999a
value: 0.1
description: Engine load is currently at 10%

Wheel based speed

id: 0x17
name: wheel_based_speed
name_cased: wheelBasedSpeed
name_pretty: Wheel based speed
type: unit.speed
size: 10
description: The vehicle speed measured at the wheel base

Example

data_component: "16014050400000000000"
value:
  kilometers_per_hour: 65
description: Wheel based speed is 65.0km/h

Battery level

id: 0x18
name: battery_level
name_cased: batteryLevel
name_pretty: Battery level
type: types.percentage
description: Battery level in %, value between 0.0 and 1.0

Example

data_component: 3fe1eb851eb851ec
value: 0.56
description: Battery level is at 56%

Check control messages

id: 0x19
name: check_control_messages
name_cased: checkControlMessages
name_pretty: Check control messages
type: types.check_control_message
multiple: true
name_singular: check_control_message

Example

data_component: 0001070140f9c78000000000000c436865636b20656e67696e650005416c657274
values:
  id: 1
  remaining_time:
    minutes: 105592
  text: Check engine
  status: Alert
description: 105'592 minutes remaining for Check Engine Alert control message with ID 1

Tire pressures

id: 0x1a
name: tire_pressures
name_cased: tirePressures
name_pretty: Tire pressures
type: types.tire_pressure
multiple: true
name_singular: tire_pressure

Example

data_component: 00150640027ae147ae147b
values:
  location: front_left
  pressure:
    bars: 2.31
description: Front left tire pressure is 2.31BAR
data_component: 01150640027ae147ae147b
values:
  location: front_right
  pressure:
    bars: 2.31
description: Front right tire pressure is 2.31BAR
data_component: 0215064001eb851eb851ec
values:
  location: rear_right
  pressure:
    bars: 2.24
description: Rear right tire pressure is 2.24BAR
data_component: 0315064001eb851eb851ec
values:
  location: rear_left
  pressure:
    bars: 2.24
description: Rear left tire pressure is 2.24BAR
data_component: "0415064002000000000000"
values:
  location: rear_right_outer
  pressure:
    bars: 2.25
description: Rear right outer tire pressure is 2.25BAR
data_component: "0515064002000000000000"
values:
  location: rear_left_outer
  pressure:
    bars: 2.25
description: Rear left outer tire pressure is 2.25BAR

Tire temperatures

id: 0x1b
name: tire_temperatures
name_cased: tireTemperatures
name_pretty: Tire temperatures
type: types.tire_temperature
multiple: true
name_singular: tire_temperature

Example

data_component: 00170140440ccccccccccd
values:
  location: front_left
  temperature:
    celsius: 40.1
description: Front left tire temperature is 40.1°C
data_component: 011701404419999999999a
values:
  location: front_right
  temperature:
    celsius: 40.2
description: Front right tire temperature is 40.2°C
data_component: "0217014044266666666666"
values:
  location: rear_right
  temperature:
    celsius: 40.3
description: Rear right tire temperature is 40.3°C
data_component: "0317014044333333333333"
values:
  location: rear_left
  temperature:
    celsius: 40.4
description: Rear left tire temperature is 40.4°C
data_component: "0417014044400000000000"
values:
  location: rear_right_outer
  temperature:
    celsius: 40.5
description: Rear right outer tire temperature is 40.5°C
data_component: 05170140444ccccccccccd
values:
  location: rear_left_outer
  temperature:
    celsius: 40.6
description: Rear left outer tire temperature is 40.6°C

Wheel RPMs

id: 0x1c
name: wheel_rpms
name_cased: wheelRPMs
name_pretty: Wheel RPMs
type: types.wheel_rpm
multiple: true
name_singular: wheel_rpm

Example

data_component: "0003004087080000000000"
values:
  location: front_left
  rpm:
    revolutions_per_minute: 737
description: Front left wheel is doing 737.0RPM
data_component: "0103004087580000000000"
values:
  location: front_right
  rpm:
    revolutions_per_minute: 747
description: Front right wheel is doing 747.0RPM
data_component: "0203004088480000000000"
values:
  location: rear_right
  rpm:
    revolutions_per_minute: 777
description: Rear right wheel is doing 777.0RPM
data_component: "0303004088980000000000"
values:
  location: rear_left
  rpm:
    revolutions_per_minute: 787
description: Rear left wheel is doing 787.0RPM
data_component: "0403004088e80000000000"
values:
  location: rear_right_outer
  rpm:
    revolutions_per_minute: 797
description: Rear right outer wheel is doing 797.0RPM
data_component: "0503004089380000000000"
values:
  location: rear_left_outer
  rpm:
    revolutions_per_minute: 807
description: Rear left outer wheel is doing 807.0RPM

Trouble codes

id: 0x1d
name: trouble_codes
name_cased: troubleCodes
name_pretty: Trouble codes
type: types.trouble_code
multiple: true
name_singular: trouble_code

Example

data_component: 0200074331313136464100095244555f3231324652000750454e44494e4700
values:
  occurrences: 2
  id: C1116FA
  ecu_id: RDU_212FR
  status: PENDING
  system: unknown
description: Trouble code 'C1116FA' with ECU-ID 'RDU_212FR' occurred 2 times and
  is 'PENDING'
data_component: 020007433136334146410006445452323132000750454e44494e4701
values:
  occurrences: 2
  id: C163AFA
  ecu_id: DTR212
  status: PENDING
  system: body
description: Trouble code 'C163AFA' with ECU-ID 'DTR212' occurred 2 times in
  body-system and is 'PENDING'

Mileage meters

id: 0x1e
name: mileage_meters
name_cased: mileageMeters
name_pretty: Mileage meters
deprecated:
  new_name: odometer
  reason: "'mileage' is an incorrect term for this"
type: unit.length
size: 10
description: The vehicle mileage (odometer) in meters

Example

data_component: 120441024f8800000000
value:
  kilometers: 150001
description: Odometer is showing 150'001km

Odometer

id: 0x1f
name: odometer
name_cased: odometer
name_pretty: Odometer
type: unit.length
size: 10
description: The vehicle odometer value in a given units

Example

data_component: 120440a0040000000000
value:
  kilometers: 2050
description: Odometer is showing 2050.0km

Engine total operation time

id: 0x20
name: engine_total_operating_time
name_cased: engineTotalOperatingTime
name_pretty: Engine total operation time
type: unit.duration
size: 10
description: The accumulated time of engine operation

Example

data_component: 0702409772999999999a
value:
  hours: 1500.65
description: The engine has operated 1'500.65h in total

Tire pressure statuses

id: 0x21
name: tire_pressure_statuses
name_cased: tirePressureStatuses
name_pretty: Tire pressure statuses
type: types.tire_pressure_status
multiple: true
name_singular: tire_pressure_status

Example

data_component: "0000"
values:
  location: front_left
  status: normal
description: Front left tire pressure is normal
data_component: "0101"
values:
  location: front_right
  status: low
description: Front right tire pressure is low
data_component: "0202"
values:
  location: rear_right
  status: alert
description: Rear right tire pressure status alert
data_component: "0300"
values:
  location: rear_left
  status: normal
description: Rear left tire pressure is normal
data_component: "0400"
values:
  location: rear_right_outer
  status: normal
description: Rear right outer tire pressure is normal
data_component: "0500"
values:
  location: rear_left_outer
  status: normal
description: Rear left outer tire pressure is normal

Brake lining wear pre-warning

id: 0x22
name: brake_lining_wear_pre_warning
name_cased: brakeLiningWearPreWarning
name_pretty: Brake lining wear pre-warning
type: types.active_state
description: Status of brake lining wear pre-warning

Example

data_component: "00"
value: inactive
description: Brake lining wear pre-warning is inactive

Engine oil life remaining

id: 0x23
name: engine_oil_life_remaining
name_cased: engineOilLifeRemaining
name_pretty: Engine oil life remaining
type: types.percentage
size: 8
description: Remaining life of engine oil which decreases over time

Example

data_component: 3fec28f5c28f5c29
value: 0.88
description: Engine oil life remaining is 88%

OEM trouble code values

id: 0x24
name: oem_trouble_code_values
name_cased: oemTroubleCodeValues
name_pretty: OEM trouble code values
type: types.oem_trouble_code_value
multiple: true
description: Additional OEM trouble codes

Example

data_component: 000531323349440018000a736f6d655f6572726f72000a736f6d655f76616c7565
values:
  id: 123ID
  key_value:
    key: some_error
    value: some_value
description: Trouble code '123ID' has a value 'some_value' for a key 'some_error'
data_component: 0004314233430022000f696d706f7274616e745f6572726f72000f73797374656d206661756c74203332
values:
  id: 1B3C
  key_value:
    key: important_error
    value: system fault 32
description: Trouble code '1B3C' has a value 'system fault 32' for a key 'important_error'

Diesel exhaust fluid range

id: 0x25
name: diesel_exhaust_fluid_range
name_cased: dieselExhaustFluidRange
name_pretty: Diesel exhaust fluid range
type: unit.length
size: 10
description: Distance remaining until diesel exhaust fluid is empty

Example

data_component: 120440a1720000000000
value:
  kilometers: 2233
description: Diesel exhaust fluid is empty in 2233.0km

Diesel particulate filter soot level

id: 0x26
name: diesel_particulate_filter_soot_level
name_cased: dieselParticulateFilterSootLevel
name_pretty: Diesel particulate filter soot level
type: types.percentage
size: 8
description: Level of soot in diesel exhaust particulate filter

Example

data_component: 3fc47ae147ae147b
value: 0.16
description: Diesel exhaust particulate filter soot level is 16%

Confirmed trouble codes

id: 0x27
name: confirmed_trouble_codes
name_cased: confirmedTroubleCodes
name_pretty: Confirmed trouble codes
type: types.confirmed_trouble_code
multiple: true
name_singular: confirmed_trouble_code

Example

data_component: "00063830314331300002313600034341530006414354495645"
values:
  id: 801C10
  ecu_address: "16"
  ecu_variant_name: CAS
  status: ACTIVE
description: Confirmed trouble code '801C10' with ECU address '16' and variante
  name "CAS" is 'ACTIVE'
data_component: "00064435324334340002343800034341530006414354495645"
values:
  id: D52C44
  ecu_address: "48"
  ecu_variant_name: CAS
  status: ACTIVE
description: Confirmed trouble code 'D52C44' with ECU address '48' and variante
  name "CAS" is 'ACTIVE'

Diesel exhaust filter status

id: 0x28
name: diesel_exhaust_filter_status
name_cased: dieselExhaustFilterStatus
name_pretty: Diesel exhaust filter status
type: types.diesel_exhaust_filter_status

Example

data_component: "000100"
values:
  status: unknown
  component: exhaust_filter
  cleaning: unknown
description: Diesel 'exhaust filter' is in 'unknown' status and unknown cleaning state
data_component: "010100"
values:
  status: normal_operation
  component: exhaust_filter
  cleaning: unknown
description: Diesel 'exhaust filter' is in 'normal operation' status unknown cleaning state
data_component: "020100"
values:
  status: overloaded
  component: exhaust_filter
  cleaning: unknown
description: Diesel 'exhaust filter' is in 'overloaded' status and unknown cleaning state
data_component: "030100"
values:
  status: at_limit
  component: exhaust_filter
  cleaning: unknown
description: Diesel 'exhaust filter' is in 'at_limit' status and unknown cleaning state
data_component: "040100"
values:
  status: over_limit
  component: exhaust_filter
  cleaning: unknown
description: Diesel 'exhaust filter' is in 'over_limit' status and unknown cleaning state