Webhooks
SupportAPI Feedback
Start typing to search…

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

Field

Description

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 4 days ago