E
Exodus API
Docs & Playground
Events/get_events

get_eventstoken required

Returns vehicle events filtered by category, severity, license/vehicle/chassis and last_time.

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

Parameters

NameTypeRequiredDescription
env_idnumberoptionalTenant environment id; defaults to the session env_id.e.g. 7
event_category_idstringoptionalComma-separated list of event category ids (each parsed as int).e.g. 1,2,3
severity_levelnumberoptionalNumeric severity threshold.e.g. 2
license_numberstringoptionalLicense plate filter.e.g. AB-123-CD
vehicle_idnumberoptionalInternal vehicle id.e.g. 555
chassis_numberstringoptionalVIN / chassis serial filter.e.g. 1HGCM82633A004352
last_timedateoptionalOnly return events after this timestamp.e.g. 2026-04-27T00:00:00Z

Notes

Requires a valid session token. String fields are url-encoded for legacy compatibility.

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_events","parameters":[{"name":"env_id","value":7},{"name":"event_category_id","value":"1,2,3"},{"name":"severity_level","value":2},{"name":"license_number","value":"AB-123-CD"},{"name":"vehicle_id","value":555},{"name":"chassis_number","value":"1HGCM82633A004352"},{"name":"last_time","value":"2026-04-27T00:00:00Z"}]}}'
Body
{
  "action": {
    "name": "get_events",
    "parameters": [
      {
        "name": "env_id",
        "value": "7"
      },
      {
        "name": "event_category_id",
        "value": "1,2,3"
      },
      {
        "name": "severity_level",
        "value": "2"
      },
      {
        "name": "license_number",
        "value": "AB-123-CD"
      },
      {
        "name": "vehicle_id",
        "value": "555"
      },
      {
        "name": "chassis_number",
        "value": "1HGCM82633A004352"
      },
      {
        "name": "last_time",
        "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_events",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "event_id": "98765432",
          "event_type_id": "12",
          "event_type_description": "Harsh%20Braking",
          "event_category": "3",
          "event_category_description": "Driving%20Behavior",
          "vehicle_id": "555",
          "license_number": "AB-123-CD",
          "chassis_number": "1HGCM82633A004352",
          "drive_id": "44321",
          "time": "2026-04-27T08%3A05%3A12Z",
          "driver_id": "789",
          "driver_name": "John%20Doe",
          "worker_id": "W-789",
          "driver_number": "DRV-789",
          "longitude": "34.8000000",
          "latitude": "32.0901000",
          "direction": "182",
          "speed": "55",
          "mileage": "152305.10",
          "client_id": "42",
          "client_name": "Acme%20Logistics"
        }
      ]
    }
  }
}