Skip to main content

​
Overview

Returns DTC (Diagnostic Trouble Code) records from the most recent engine fault event for a vehicle. V2 returns enriched data including AI-generated descriptions, possible causes, recommended actions, severity, and the location where the fault was detected.
The V1 version of this endpoint is DTC codes. V2 is paginated and significantly enriched.
Rate limit: 30 requests per 60 seconds per token.

​
Endpoint

GET /api/v2/vehicles/{id}/dtc

​
Path parameters

​
id
integer
required
Legacy vehicle ID.

​
Query parameters

​
page
integer
default:"1"
Page number (1-based).
​
pageSize
integer
default:"50"
Records per page.

​
Response

200 OK — PagedListResult<DtcDto>
FieldTypeDescription
codestringRaw DTC code (e.g. P0420)
descriptionstringCode description
whyThisMattersstring[]Impact on vehicle operation
possibleCausesstring[]Likely root causes
recommendedActionsstring[]Suggested remediation steps
severitystring | nullUrgency level (e.g. "High", "Medium", "Low"); may be null for older cached data
detectedAtdatetime | nullWhen the fault was detected (user’s timezone)
detectedAtFormattedstringFormatted detection timestamp
location.addressstring | nullStreet address where the fault was detected (null if geocoding failed)
location.latitudenumber | nullLatitude of detection
location.longitudenumber | nullLongitude of detection

​
Example response

{
  "items": [
    {
      "code": "P0420",
      "description": "Catalyst System Efficiency Below Threshold (Bank 1)",
      "whyThisMatters": ["Reduced emissions control", "Potential fuel efficiency loss"],
      "possibleCauses": ["Worn catalytic converter", "Faulty O2 sensor"],
      "recommendedActions": ["Inspect catalytic converter", "Check oxygen sensors"],
      "severity": "Medium",
      "detectedAt": "2026-04-27T14:30:00",
      "detectedAtFormatted": "27 Apr 2026 2:30 PM",
      "location": {
        "address": "42 George St, Sydney NSW 2000",
        "latitude": -33.8688,
        "longitude": 151.2093
      }
    }
  ],
  "currentPage": 1,
  "numberOfPages": 1,
  "totalResults": 1,
  "lastResultIndex": 0
}

​
Error responses

StatusMeaning
401Token does not have access to this vehicle
404Vehicle not found
curl "https://api.telemax.com.au/api/v2/vehicles/88421/dtc" \
  -H "Authorization: Bearer <token>"