Diagnostics

The Diagnostics endpoint provides access to vehicle diagnostic trouble codes (DTCs), maintenance indicators, and overall health status.

Endpoint

Method	Path	Description
GET	/v1/vehicles/{vin}/diagnostics	Diagnostic data

Requires a DPoP-bound access token.

Retrieving diagnostics

curl -X GET https://api.data.jlr-vcdp.com/v1/vehicles/SALGA2BN6PH123456/diagnostics \
  -H "Authorization: DPoP YOUR_ACCESS_TOKEN" \
  -H "DPoP: YOUR_DPOP_PROOF"

Response:

{
  "vin": "SALGA2BN6PH123456",
  "troubleCodes": [
    {
      "code": "P0A80",
      "system": "high-voltage-battery",
      "severity": "warning",
      "description": "Replace hybrid/EV battery pack — cell imbalance detected",
      "active": true,
      "detectedAt": "2024-06-10T09:15:00Z",
      "odometerAtDetection": { "value": 12340.2, "unit": "km" }
    }
  ],
  "maintenanceIndicators": [
    {
      "item": "Brake fluid change",
      "status": "due-soon",
      "dueDate": "2024-08-01",
      "dueDistance": { "value": 1500, "unit": "km" }
    }
  ],
  "overallHealth": "attention-required",
  "lastUpdated": "2024-06-15T14:30:00Z"
}

Overall health states

State	Description
good	No active faults
attention-required	Minor issues present
service-required	Critical faults detected

Trouble code severity

Severity	Description
info	Informational — no action required
warning	Advisory — monitor or schedule service
critical	Immediate attention needed

Maintenance status

Status	Description
ok	No action needed
due-soon	Service approaching
overdue	Past scheduled service date