Vehicle Diagnostics

The Diagnostic API allows you to retrieve diagnostic information and DTCs (Diagnostic Trouble Code) reported by the OBD system of your vehicle. A DTC is an alphanumeric code used to identify vehicle problems. For example, the DTC C1446 indicates a brake switch circuit failure.

The API response contains information such as the diagnostic code, definition of the code, vehicle name, location, and timestamp.

Diagnostic information of multiple vehicles can be obtained in a single API call.


Sample Request

   "fromDate":"2016-06-20 00:00:00",
   "toDate":"2016-06-21 23:59:00"

API Response explanation

codeAPI Status Code
messageAPI Message (Success/Failure)
reasonReason for failure
generatedAtAPI generation timestamp in UTC
dtcMessageIdMessage ID (internal reference)
vehicleName of the vehicle
addressAddress of the location where the DTC was generated
DateTimeDTC generation timestamp in milliseconds
codeDiagnostic troubleshooting code (DTC) reported by the vehicle
deviceIdUnique identifier of the device plugged into the vehicle
descriptionSimple description for the DTC
assetnoAsset number of the vehicle
firstNameFirst name of the driver
lastNameLast name of the driver
parentGroupParent of the vehicle’s group
latLatitude coordinate of the location where the DTC was generated
lngLongitude coordinate of the location where the DTC was generated
foreParentGroupFore parent of the vehicle’s group
offsetTime offset in minutes
displayTimeZoneTimezone of the vehicle
groupName of the vehicle’s group
Click Try It! to start a request and see the response here!