Guides
SupportAPI Feedback

DTC Message

The DTC_MESSAGE event is used to notify when a Diagnostic Trouble Code (DTC) is detected by the vehicle. This helps identify potential issues with the engine or other vehicle systems in real time.

Event Type: DTC_MESSAGE

Trigger Condition

Subscription to the DTC_MESSAGE event is mandatory.
This event is triggered instantly when a Diagnostic Trouble Code is reported from the vehicle.

Example Payload

{
  "inputBit7": 0,
  "partialUpdate": false,
  "inputBit4": 0,
  "voiceCallActive": 0,
  "inputBit3": 0,
  "inputBit6": 0,
  "inputBit5": 0,
  "type": "DTC_MESSAGE",
  "deviceId": "899ee883-730b-11ec-9d03-7dafd4966ebd",
  "networkService": 0,
  "commStateConnected": 0,
  "messageType": "DTC_MESSAGE",
  "messageIndex": "129034203",
  "dimentionFix": 0,
  "lastKnownLon": -113.0834524,
  "inputBit0": 0,
  "inputBit2": 0,
  "id": "1c004e81-f300-476b-97b3-573ee18a21a2",
  "state": null,
  "inputBit1": 0,
  "commStatusAvaliable": 0,
  "locality": null,
  "eventIndex": 0,
  "assetNo": "",
  "fixStatusCorrected": 0,
  "deviceSerial": "1102104537",
  "groupName": "Default Group",
  "lastKnownTime": 1662612123000,
  "jmsType": "",
  "vehicleName": "TR-52 - TR-52",
  "deviceTypeId": 1,
  "destinationQueues": null,
  "city": null,
  "latitude": 37.6557019,
  "unitStatus": 0,
  "invalidFix": 0,
  "dataService": 0,
  "noOfAccums": 0,
  "customerId": 13211,
  "beaconMacAddress": null,
  "tripNumber": 437,
  "spare": 0,
  "address": null,
  "roaming": 0,
  "messageEventType": null,
  "stateId": 0,
  "updateTime": null,
  "userId": "8a9388a8-7dd7-5b7e-017e-4a6140166ed2",
  "batteryPercentage": 0,
  "currentState": 0,
  "deviceProtocolMessageId": null,
  "messageEventTypeId": 0,
  "zipCode": null,
  "country": null,
  "deviceAssociatedVIN": "1XKDD49X8EJ404392",
  "beaconType": null,
  "groupId": "f181e25b-778c-11eb-8959-a5ce01ad0f88",
  "vendorTypeId": 1,
  "firmwareVersion": null,
  "fixStatuslastKnown": 0,
  "fixStatusHistoric": 0,
  "longitude": -113.0834524,
  "satellites": null,
  "locationTime": 1662612123000,
  "odometer": 489455,
  "offset": -360,
  "virtualTripEnd": false,
  "imei_meid": "352602115820893",
  "insideHOO": true,
  "milStatus": 1,
  "timeOfFix": null,
  "sensorNames": null,
  "tripPolyline": null,
  "lastKnownLat": 37.6557019,
  "fixQuality": 0,
  "unitStatusBit0": 0,
  "unitStatusBit2": 0,
  "unitStatusBit1": 0,
  "unitStatusBit3": 0,
  "storedLocation": false,
  "protocolVersionIdChange": false,
  "accumesList": null,
  "accumulators": null,
  "fixStatusPredict": 0,
  "network3G": 0,
  "lastKnownAddress": null,
  "privacyModeEnable": false,
  "fixStatus": 0,
  "vehicleId": "899ee882-730b-11ec-9d03-559d1571375a",
  "lastKnownFixQuality": 0,
  "dtcMessageRecords": [
    {
      "dtcType": 0,
      "suspectIdentification": 3698,
      "failureMode": 9,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 17777,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 77,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 38,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 830,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 442,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 78,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 441,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 1388,
      "failureMode": 3,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    },
    {
      "dtcType": 0,
      "suspectIdentification": 3697,
      "failureMode": 9,
      "subType": "DTC_MESSAGE_RECORD_JBUS1939"
    }
  ],
  "dtcCount": 10,
  "userName": "1102104537",
  "tripState": "ACTIVE",
  "messageTypeId": 18,
  "obdSpeed": null,
  "location": {
    "latitude": 37.6557019,
    "longitude": -113.0834524
  },
  "commonState": 0,
  "carrierId": null
}

Reference

FieldDescription
type
String		Type of event.
Example: DTC_MESSAGE
deviceId
String,UUID		Unique identifier of the device.
Example: 899ee883-730b-11ec-9d03-7dafd4966ebd
messageType
String		Type of message.
Example: DTC_MESSAGE
lastKnownLon
Double		Last known longitude of vehicle in degrees.
Example: -113.0834524
id
String,UUID		Unique identifier of the message.
Example: 1c004e81-f300-476b-97b3-573ee18a21a2
deviceSerial
String		Serial number of the device.
Example: 1102104537
groupName
String		Name of the assigned group.
Example: Default Group
lastKnownTime
TimeStamp		Last known time in milliseconds.
Example: 1662614865000
vehicleName
String		Name of the vehicle.
Example: TR-52 - TR-52
deviceTypeId
Integer		Type ID of the device, 1-Datalogger
Example: 1
customerId
Integer		Unique Azuga ID of the customer.
Example: 13211
tripNumber
Integer		Represents a unique ID assigned to a specific trip, allowing the system to track and reference that particular journey or route.
Example: 437
userId
String,UUID		Unique ID of the user.
Example: 8a9388a8-7dd7-5b7e-017e-4a6140166ed2
batteryPercentage
Integer		Device battery percentage.
Example: 0
messageEventTypeId
Integer		Event type identifier.
Example: 0
deviceAssociatedVIN
String		VIN associated with the device..
Example: 1XKDD49X8EJ404392
groupId
String,UUID		Unique Identifier of the Group.
Example: f181e25b-778c-11eb-8959-a5ce01ad0f88
vendorTypeId
Integer		Vendor type ID.
Example: 1
locationTime
Time Stamp		Time the location was recorded in milliseconds.
Example: 1662614865000
odometer
Integer		Odometer reading in kilometers.
Example: 489455
offset
Integer		Time zone offset.
Example: -360
virtualTripEnd
Boolean		Indicates whether the trip ended virtually.
Example: false
imei_meid
String		IMEI/MEID of the device.
Example: 352602115820893
insideHOO
Boolean		Indicates if inside hours of operation.
Example: true
milStatus
Integer		MIL (Malfunction Indicator Lamp) status.
Example: 1
lastKnownLat
Double		Last known latitude of vehicle in degrees.
Example: 37.6557019
storedLocation
Boolean		Indicates whether location is stored.
Example: false
protocolVersionIdChange
Boolean		Indicates whether protocol version changed.
Example: false
privacyModeEnable
Boolean		Indicates if privacy mode is enabled.
Example: false
vehicleId
String,UUID		Unique ID for the vehicle.
Example: 899ee882-730b-11ec-9d03-559d1571375a
dtcCount
Integer		Count of DTC records in the message.
Example: 10
userName
String		Name of the user.
Example: Henry BRANDON
tripState
String		State of the trip.
Example: ACTIVE
location
Location {
latitude: 34.12
longitude: -82.14
}		Current location object of the vehicle
latitude
Double		Latitude co-ordinate value in degrees
Example: 34.12
longitude
Double		Longitude co-ordinate value in degrees
Example: -82.34
dtcMessageRecords

dtcType: 0
suspectIdentification: 3698
failureMode: 9
subType: DTC_MESSAGE_RECORD_JBUS1939		Object list of DTC records:
dtcType
Integer		Represents the type or category of the Diagnostic Trouble Code (DTC). Values typically indicate whether the fault is active, historical, pending, or system-specific.
Example: 0
suspectIdentification
Integer		Identifies the suspected component, subsystem, or ECU (Electronic Control Unit) responsible for the fault. The value may refer to standardized or proprietary identifiers, depending on the communication protocol used.
Example: 3698
failureMode
Integer		Indicates the nature or severity of the fault detected. The values generally follow the J1939 standard:
0 – No fault detected (OK)
1 – Data valid but above normal operational range (Warning)
2 – Data valid but below normal operational range
3–7 – Reserved for future use or custom definitions
8 – Severe fault detected
9 – Critical fault requiring immediate action (e.g., shutdown)
These codes describe how serious the fault is and what type of intervention may be required..
Example: 9
subType
String		Specifies the format or schema used to interpret the DTC record. This value helps identify the standard (e.g., J1939) under which the DTC is reported.
Example: "DTC_MESSAGE_RECORD_JBUS1939"

Updated about 1 year ago

Did this page help you?