Skip to main content
GET
Engine codes (V2)

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: 10 req/s · 30/min · 6,000/hr · 144,000/day

Endpoint

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

Path parameters

integer
required
Vehicle ID.

Query parameters

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

Response

200 OKPagedListResult<EngineCodeDto>
When a vehicle has no engine codes, the API returns items: null (not []) and currentPage: 0 (not 1). Always null-check items before iterating.

Example response

Error responses

Authorizations

Authorization
string
header
required

JWT Bearer token obtained from POST /v2/api/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