Skip to main content
GET
/
api
/
v2
/
vehicles
/
{id}
/
engine-codes
Engine codes (V2)
curl --request GET \
  --url https://api.telemax.com.au/api/v2/vehicles/{id}/engine-codes \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "code": "P0420",
      "description": "Catalyst System Efficiency Below Threshold (Bank 1)",
      "whyThisMatters": [
        "This fault indicates your catalytic converter is no longer processing exhaust gases effectively, which means your vehicle is producing higher levels of harmful emissions than permitted.",
        "If left unaddressed, the engine management system may enter a reduced-power mode, leading to noticeably worse fuel economy and throttle response.",
        "In some regions this fault will cause the vehicle to fail an emissions inspection."
      ],
      "possibleCauses": [
        "The catalytic converter itself has degraded or been poisoned — commonly caused by using leaded fuel, coolant leaks into the exhaust, or high-mileage wear.",
        "A faulty upstream or downstream oxygen sensor is reporting incorrect readings, making a healthy converter appear to be failing.",
        "An exhaust leak upstream of the converter is allowing unmetered air to enter, skewing the sensor readings."
      ],
      "recommendedActions": [
        "Begin by scanning for any additional fault codes, particularly oxygen sensor faults (P0130–P0167), as these should be resolved first before condemning the catalytic converter.",
        "Inspect the exhaust system for any leaks between the engine and the catalytic converter, and repair any found.",
        "If the oxygen sensors test within spec and there are no exhaust leaks, have the catalytic converter tested for flow restriction and converter efficiency under load — replacement is likely required."
      ],
      "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
      }
    }
  ],
  "totalResults": 1,
  "lastResultIndex": 1,
  "currentPage": 1,
  "numberOfPages": 1
}

Overview

Returns engine code (OBD-II / Diagnostic Trouble Code) records from the most recent engine fault event for a vehicle. Each code is enriched with AI-generated analysis including a plain-English explanation of why it matters, a list of possible root causes, and step-by-step recommended actions — written as full descriptive sentences, not short labels.
The V1 version of this endpoint is DTC codes. V2 is paginated, significantly enriched with AI analysis, and the path has changed from /dtc to /engine-codes.
Rate limit: 30 requests per 60 seconds per token.

Endpoint

GET /api/v2/vehicles/{id}/engine-codes

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 OKPagedListResult<EngineCodeDto>
FieldTypeDescription
codestringRaw OBD-II code (e.g. P0420)
descriptionstringStandard code description (e.g. "Catalyst System Efficiency Below Threshold (Bank 1)")
whyThisMattersstring[]AI-generated full sentences explaining the impact on vehicle operation and safety
possibleCausesstring[]AI-generated full sentences describing the most likely root causes
recommendedActionsstring[]AI-generated full sentences with step-by-step recommended actions
severitystring | nullUrgency level: "High", "Medium", or "Low". May be null for older cached records
detectedAtdatetime | nullWhen the fault was detected (user’s local timezone)
detectedAtFormattedstringHuman-readable formatted timestamp
location.addressstring | nullStreet address where the fault was detected; null if geocoding failed
location.latitudenumber | nullLatitude of detection location
location.longitudenumber | nullLongitude of detection location

Example response

{
  "items": [
    {
      "code": "P0420",
      "description": "Catalyst System Efficiency Below Threshold (Bank 1)",
      "whyThisMatters": [
        "This fault indicates your catalytic converter is no longer processing exhaust gases effectively, which means your vehicle is producing higher levels of harmful emissions than permitted.",
        "If left unaddressed, the engine management system may enter a reduced-power mode, leading to noticeably worse fuel economy and throttle response.",
        "In some regions this fault will cause the vehicle to fail an emissions inspection."
      ],
      "possibleCauses": [
        "The catalytic converter itself has degraded or been poisoned — commonly caused by using leaded fuel, coolant leaks into the exhaust, or high-mileage wear.",
        "A faulty upstream or downstream oxygen sensor is reporting incorrect readings, making a healthy converter appear to be failing.",
        "An exhaust leak upstream of the converter is allowing unmetered air to enter, skewing the sensor readings."
      ],
      "recommendedActions": [
        "Begin by scanning for any additional fault codes, particularly oxygen sensor faults (P0130–P0167), as these should be resolved first before condemning the catalytic converter.",
        "Inspect the exhaust system for any leaks between the engine and the catalytic converter, and repair any found.",
        "If the oxygen sensors test within spec and there are no exhaust leaks, have the catalytic converter tested for flow restriction and converter efficiency under load — replacement is likely required."
      ],
      "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/engine-codes" \
  -H "Authorization: Bearer <token>"

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /api/v2/authentication/token/api-key.

Lifetime: ~24 hours (86,399 seconds). Cache the token and reuse it. Re-authenticate 5 minutes before expiry.

Scoping: API key tokens are scoped to the company the key belongs to and may restrict access to a vehicle allowlist and/or action set (see token claims).

No refresh endpoint — re-authenticate with your API key when the token expires.

Path Parameters

id
integer
required

Query Parameters

page
integer
default:1
pageSize
integer
default:50

Response

Successful response