Get Diagnostic Report (GET)

Diagnostic reports are generated as a result of ‘Update Vehicle Odo and OBD’ API to pass along vehicle OBD2 information. If the user has a Check Engine Light or pending issues, a diagnostic report is generated. This report contains all the information pertaining to that code, including but not limited to, the laymen meaning and severity of the code, the possible causes, and the most-likely repair.

http://api2.carmd.com/v2.0/report/diagnostic?reportID=reportID1,reportID2
http://api2.carmd.com/v2.0/report/diagnostic?uploadID=uploadID1,uploadID2
http://api2.carmd.com/v2.0/report/diagnostic?vehicleID=vehicleID1,vehicleID2
http://api2.carmd.com/v2.0/report/diagnostic?tag=tag1,tag2
http://api2.carmd.com/v2.0/report/diagnostic?fleetID=fleetID1
http://api2.carmd.com/v2.0/report/diagnostic?fleetID=fleetID&dateCreated=dateCreated

Example

http://api2.carmd.com/v2.0/report/diagnostic?reportID=541655173c10813ac8a0f763
http://api2.carmd.com/v2.0/report/diagnostic?uploadID=541655173c10813ac8a0f763
http://api2.carmd.com/v2.0/report/diagnostic?vehicleID=541655333c10813ac8a0f766
http://api2.carmd.com/v2.0/report/diagnostic?tag=Cars,Trucks
http://api2.carmd.com/v2.0/report/diagnostic?fleetID=541655173c10813ac8a0f763
http://api2.carmd.com/v2.0/report/diagnostic?fleetID=541655173c10813ac8a0f763,dateCreated={% createddate# %}

URL Parameters

Get report by reportID

Field Type Notes
reportID string Required. Separate by commas. Retrieves report by reportID.
dateCreated string Optional. A filter that excludes reports created before suggested date.

Get report by uploadID

Field Type Notes
uploadID string Required. Separate by commas. Retrieves report by uploadID.
dateCreated string Optional. A filter that excludes reports created before suggested date.

Get report(s) by vehicleID

Field Type Notes
vehicleID string Required. Separate by commas. Retrieves the report history of vehicle.
dateCreated string Optional. A filter that excludes reports created before suggested date.

Get report(s) by tag

Field Type Notes
tag string Required. Separate by commas. Retrieves the report history of vehicles with this tag.
dateCreated string Optional. A filter that excludes reports created before suggested date.

Get report by fleetID

Field Type Notes
fleetID string Required. Retrieves report by fleetID.
dateCreated string Optional. A filter that excludes reports created before suggested date.

Response


{
"message": {
"code": 0,
"message": "OK",
"credentials": "Valid",
"version": "v2.0.0",
"account": "Free",
"method": "Get Diagnostic Report ",
"action": "GET",
"counter": 243
},
"data": [
{
"reportID": "54f026c83c10814ea02e2cef",
"fix": [
{
"dateCreated": "0001-01-01T00:00:00",
"name": "Clean Ground Wire",
"desc": "Check engine , body & pcm grounds. Must be clean and tight. ",
"errCode": "P0505",
"errType": 0,
"fixRating": 1,
"laborCost": 108.36,
"laborHours": 1,
"laborRate": 108.36,
"partsCost": 0,
"additionalCost": 25,
"totalCost": 133.36,
"fixParts": null
}
],
"codes": {
"pwrPrimary": "P0505",
"pwrStored": "U1022,P0505",
"pwrPending": "P0505,U1022",
"absPrimary": "",
"absStored": "C0012",
"absPending": "",
"srsPrimary": "",
"srsStored": "B0015",
"srsPending": ""
},
"definition": [
{
"code": "P0505",
"type": "PowerTrain",
"serverity": 0,
"condition": "Engine started, ECT sensor signal more than 140ºF, engine running at idle speed with the throttle closed, and the PCM detected the Actual idle speed was more than or less than the Target idle speed by too great an amount during the test.\n",
"bodyCode": null,
"engineType": null,
"laymansTermsSeverityLevel": 2,
"laymanConditions": "Code P0505 indicates a fault in the Idle Air Control System for a predetermined period of time.",
"laymanTitle": "Idle Air Control System",
"msgInidicatorLampFile": "i_Suzuki_MIL.html",
"msgIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/i_Suzuki_MIL.html",
"monitorFile": "mt_Suzuki_CCM.html",
"monitorFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/mt_Suzuki_CCM.html",
"monitorType": "CCM",
"patIndicatorLampFile": "",
"patIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"possibleCauses": "* IAC valve control circuit is open or shorted to ground\n* IAC valve power circuit is open (check power from the relay)\n* IAC valve ground circuit is open\n* IAC valve is damaged or has failed \n* PCM has failed",
"stsIndicatorLampFile": "",
"stsIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"techTitle": "Idle Speed Control System",
"tciFile": "",
"tciFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"trips": "2"
},
{
"code": "U1022",
"type": "PowerTrain",
"serverity": 1,
"condition": null,
"bodyCode": null,
"engineType": null,
"laymansTermsSeverityLevel": 0,
"laymanConditions": null,
"laymanTitle": null,
"msgInidicatorLampFile": null,
"msgIndicatorLampFileURL": null,
"monitorFile": null,
"monitorFileURL": null,
"monitorType": null,
"patIndicatorLampFile": null,
"patIndicatorLampFileURL": null,
"possibleCauses": null,
"stsIndicatorLampFile": null,
"stsIndicatorLampFileURL": null,
"techTitle": null,
"tciFile": null,
"tciFileURL": null,
"trips": null
},
{
"code": "C0012",
"type": "Abs",
"serverity": 1,
"condition": "",
"bodyCode": null,
"engineType": null,
"laymansTermsSeverityLevel": 0,
"laymanConditions": "",
"laymanTitle": "",
"msgInidicatorLampFile": "",
"msgIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"monitorFile": "",
"monitorFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"monitorType": "",
"patIndicatorLampFile": "",
"patIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"possibleCauses": "",
"stsIndicatorLampFile": "",
"stsIndicatorLampFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"techTitle": "Left Front Hydraulic Release Too Long (Subfault)",
"tciFile": "",
"tciFileURL": "http://resources.innova.testing.metafuse.com/ErrorCodeInfo/",
"trips": "0"
},
{
"code": "B0015",
"type": "Srs",
"serverity": 1,
"condition": null,
"bodyCode": null,
"engineType": null,
"laymansTermsSeverityLevel": 0,
"laymanConditions": null,
"laymanTitle": null,
"msgInidicatorLampFile": null,
"msgIndicatorLampFileURL": null,
"monitorFile": null,
"monitorFileURL": null,
"monitorType": null,
"patIndicatorLampFile": null,
"patIndicatorLampFileURL": null,
"possibleCauses": null,
"stsIndicatorLampFile": null,
"stsIndicatorLampFileURL": null,
"techTitle": null,
"tciFile": null,
"tciFileURL": null,
"trips": null
}
],
"vehicle": {
"vehicleID": "54f026583c108148643e3f41",
"fleetID": "54ed95a43c1081156ce39471",
"vehCustomID": "SUZUKI",
"vin": "JS2RD62H265350149",
"vehName": "2006 SUZUKI Areo",
"year": 2006,
"make": "SUZUKI",
"model": "AERIO",
"engine": "6",
"mileage": 7000,
"tag": "Cars,Yellow White",
"active": true
},
"status": {
"report": "Yellow",
"mil": "Not Supported",
"engine": "Red",
"powerTrain": "Red",
"abs": "Yellow",
"srs": "Yellow",
"emission": "Not Ready"
},
"monitor": null,
"freezeFrame": null,
"tsb": [],
"vin": "JS2RD62H265350149",
"mileage": 7000,
"dateCreated": "2015-02-27T08:11:52Z"
}
],
"pagination": {
"pageSize": 20,
"currentPage": 1,
"itemCount": 1,
"totalPage": 1
}
}
Field Type Notes
message Message
data list<Diagnostic> A list of diagnostic reports.

Message object

Field Type Notes
code string Message code.
message string Ok or Failed.
credentials string Valid or Invalid.
version string v2.0.0
account string Free or Premium
method string Name of the API called
action string returns a GET, POST, PUT, DELETE
counter integer Counter for this request. Increments by one for every request made. This is only important for free users who have a limited number of API requests.

Diagnostic object

Field Type Notes
reportID string ID used to pull this report from the Get Report API.
fix list<Fix> A list of possible fixes for this issue.
codes ErrorCode The error codes retrieved from the vehicle.
definition list<CodeDefinition> Definitions of the codes retrieved from the vehicle. Contains both laymen and fairly technical information.
status Status Current status of the various systems, such as check engine light, emission status, etc.
tsb list<TSB> List of tsbID associated with this issue.
monitor list<KeyValue> Monitor information at the time when this error occurred.
freezeFrame list<KeyValue> Freeze frame information at the time when this error occurred.
mileage string The odometer reading of the vehicle when this issue occurred.
dateCreated string The date when this error occurred.
vehicle Vehicle General vehicle information.

Fix object

Field Type Notes
name string Name of the fix.
desc string Description of the fix.
dateCreated string The date when this fix was generated.
errCode string
errType integer
{% fixrating %} integer
laborHours decimal Roughly how long it will take a mechanic to make the repair.
laborRate decimal Roughly how much a mechanic costs per hour.
laborCost decimal Roughly how much it the service of the repair will cost in labor.
partCost decimal Roughly how much the part will cost.
additionalCost decimal Additional costs for misc, such as taxes.
totalCost decimal Roughly the total cost of the repair.
fixParts FixPart The parts needed for the repair.

FixPart object

Field Type Notes
name string Name of the part that will fix the issue.
desc string Description of the part.
manufacturer string Manufacturer of the part.
partID string ACES part number of the part.
price decimal The cost of the part.
quantity integer The number of parts needed for the repair.

ErrorCode object

Field Type Notes
pwrPrimary string The primary powertrain DTC is the DTC that caused an issue severe enough for the check engine light to come on. Also known as the MIL DTC.
pwrStored list<string>
pwrPending list<string> These are powertrain DTCs which have occurred at least once and the system is holding onto to see if it reoccurs. If the DTC fails to occur again, it is erased. If it reoccurs it matures into a primary powertrain DTC causing the check engine light to come on.
absPrimary string The primary ABS DTC is the DTC that caused an issue severe enough for the ABS warning light to come on. Also known as the ABS MIL DTC.
absStored list<string>
absPending list<string> Similar to pwrPending but for ABS.
srsPrimary string The primary SRC DTC is the DTC that caused an issue severe enough for the SRS warning light to come on. Also known as the SRS MIL DTC.
srsStored list<string>
srsPending list<string> Similar to pwrPending but for SRS.

CodeDefinition object

Field Type Notes
laymanTitle string Easy to understand english name of this error code.
code string The code of this error code.
laymansTermsSeverityLevel string This is how severe this error code is. If it is the primary code then this value can be used an indicator of how urgently this vehicle needs a repair.
1 – Ok to ignore for now
2 – Get it looked at soon
3 – Take your car in for a repair ASAP
laymanConditions string The conditions required to trigger this code.
possibleCauses string Possible causes that may have triggered this error code to turn on.
laymansTermEffectOnVehicle string Provides the effect this issue is having on the vehicle.
laymansTermResponsibleComponentOrSystem string The component or system responsible.
laymansTermWhyItsImportant string Why this component or system is important.
techTitle string Technical / Mechanic term for this error.
type string
condition string
bodyCode string
engineType string
msgInidicatorLampFile string
msgInidicatorLampFileUrl string
monitorFile string
monitorURL string
monitorType string
patIndicatorLampFile string
patIndicatorLampFileUrl string
stsIndicatorLampFile string
stsIndicatorLampFileUrl string
tcilFile string
tcilFileUrl string
trips string

Status object

Field Type Notes
report string Overall report status. Which are:
red – Primary DTC found, check engine light(CEL) is on
yellow – Pending DTC detected, CEL is not on
green – No DTCs found, vehicles are ok
mil string
engine string
powerTrain string
abs string
srs string
emission string

TSB object

Field Type Notes
tsbID string ID of this TSB
description string Description of the TSB
fileName string
fileURL string
manufacturer string
issueDate DateTime
createdDate DateTime
updatedDate DateTime
text string
system string
subSystem string
autoSystem string
dtcCodes list<string> DTC Codes associated with this TSB.
categories list<string> Categories this TSB falls under.

Key Value object

Field Type Notes
key string
value string/int/bool

Vehicle object

Field Type Notes
vehName string Name of this vehicle.
mileage integer Number of miles this vehicle has travelled.
vin string Vehicle Identification Number.
year string Year this vehicle was manufactured.
make string Make of this vehicle.
model string Model of this vehicle.
engine string Engine type of this vehicle.
vehicleID string CarMD’s generated ID for this vehicle. This ID will always be unique to this fleet.
fleetID string CarMD’s fleet ID for this vehicle.
tag list<string> Tags applied to this vehicle.
vehCustomID string Null or returns the vehCustomID of this vehicle.
active boolean True or False. True if services are available for this vehicle.

vinhnGet Diagnostic Report