E
Exodus API
Docs & Playground
Events/get_dtc_events

get_dtc_eventstoken required

Returns Diagnostic Trouble Code (DTC) events for a list of vehicles, groups or licenses over a window of up to 72 hours.

Try in playground
POST/api— body field action.name = "get_dtc_events"

Parameters

NameTypeRequiredDescription
license_liststringoptionalComma-separated list of license plates. At least one of license_list/group_list/vehicle_id_list is required.e.g. AB-123-CD,EF-456-GH
group_liststringoptionalComma-separated list of group ids.e.g. 10,11
vehicle_id_liststringoptionalComma-separated list of vehicle ids.e.g. 555,556,557
from_datedateoptionalStart of date range. Defaults to `to_date - 3 days` when omitted.e.g. 2026-04-26T00:00:00Z
to_datedateoptionalEnd of date range. Defaults to now when omitted.e.g. 2026-04-27T00:00:00Z

Notes

env_id is taken from the session only — no parameter override. At least one of `license_list`, `group_list`, or `vehicle_id_list` is required. Date defaults: `to_date` defaults to now and `from_date` defaults to `to_date - 3 days`. Window > 72 hours returns action_value '1'. `recommendation`, `duration`, `first_occured`, `last_occured` are returned as empty strings (no PG analog).

Request

curl
curl -X POST 'https://api.stage.questar.io/v2/exodus/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"get_dtc_events","parameters":[{"name":"license_list","value":"AB-123-CD,EF-456-GH"},{"name":"group_list","value":"10,11"},{"name":"vehicle_id_list","value":"555,556,557"},{"name":"from_date","value":"2026-04-26T00:00:00Z"},{"name":"to_date","value":"2026-04-27T00:00:00Z"}]}}'
Body
{
  "action": {
    "name": "get_dtc_events",
    "parameters": [
      {
        "name": "license_list",
        "value": "AB-123-CD,EF-456-GH"
      },
      {
        "name": "group_list",
        "value": "10,11"
      },
      {
        "name": "vehicle_id_list",
        "value": "555,556,557"
      },
      {
        "name": "from_date",
        "value": "2026-04-26T00:00:00Z"
      },
      {
        "name": "to_date",
        "value": "2026-04-27T00:00:00Z"
      }
    ]
  }
}

Response

Successful responses always wrap the action's payload in response.properties. The action_value field reports the handler outcome: "0" for success, "1" for invalid params, "2" for not allowed, "999" for general error.

200 OK
{
  "response": {
    "properties": {
      "action_name": "get_dtc_events",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "oid": "11223344",
          "license_nmbr": "AB-123-CD",
          "timestamp": "2026-04-27T08:10:00Z",
          "spn": "100",
          "spn_description": "Engine Oil Pressure",
          "fmi": "5",
          "fmi_description": "Current below normal",
          "source": "ECM",
          "fault_description": "Low oil pressure",
          "severity": "2",
          "sign": "1",
          "latitude": "32.0901000",
          "longitude": "34.8000000",
          "additional_fault_description": "",
          "recommendation": "",
          "duration": "",
          "first_occured": "",
          "last_occured": "",
          "vehicle_id": "555",
          "group_id": "10",
          "group_name": "Tel Aviv Fleet"
        }
      ]
    }
  }
}