Events/get_trip_events

get_trip_eventstoken required

Returns events that occurred during a single trip (drive_id), with V3-compatible duration logic.

POST/api— body field action.name = "get_trip_events"

Parameters

NameTypeRequiredDescription
drive_idstringrequiredThe drive/trip id whose events should be loaded.e.g. 44321
versionstringoptionalOptional version flag, default '4'. Accepted but ignored — the response always returns the V4 field set.e.g. 4

Notes

env_id is taken from the session only — no parameter override. Trip access is checked against session.client_id.

Request

curl
curl -X POST 'https://api.questarauto.com/v2/exodus/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"get_trip_events","parameters":[{"name":"drive_id","value":"44321"},{"name":"version","value":"4"}]}}'
Body
{
  "action": {
    "name": "get_trip_events",
    "parameters": [
      {
        "name": "drive_id",
        "value": "44321"
      },
      {
        "name": "version",
        "value": "4"
      }
    ]
  }
}

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_trip_events",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "trip_id": "44321",
          "event_id": "98765432",
          "vehicle_id": "555",
          "license_number": "AB-123-CD",
          "time": "2026-04-27T08:05:12",
          "event_type_id": "12",
          "event_type_description": "Harsh Braking",
          "event_category": "3",
          "event_category_description": "Driving Behavior",
          "latitude": "32.0901000",
          "longitude": "34.8000000",
          "speed": "55.20",
          "direction": "182",
          "driver_id": "789",
          "driver_name": "John Doe",
          "driver_code": "DRV-789",
          "worker_id": "W-789",
          "end_time": "2026-04-27T08:05:18",
          "end_latitude": "",
          "end_longitude": "",
          "event_duration_seconds": "6",
          "odometer": null
        }
      ]
    }
  }
}