E
Exodus API
Docs & Playground
Events/get_incremental_events

get_incremental_eventstoken required

Streaming-style endpoint: returns events with an id strictly greater than `last_event_id`, optionally filtered.

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

Parameters

NameTypeRequiredDescription
last_event_idstringoptionalHigh-water-mark event id. Defaults to '0'. Treated as a string to support 64-bit ids.e.g. 98765432
license_numberstringoptionalLicense plate filter. Alias: `license_nmbr`.e.g. AB-123-CD
severity_levelnumberoptionalNumeric severity threshold.e.g. 2
event_category_idstringoptionalComma-separated list of positive event category ids.e.g. 1,2,3

Notes

env_id is taken from the session only — no parameter override. `last_event_id` defaults to `'0'` when omitted (treated as a string to support 64-bit ids). `license_nmbr` accepted as alias for `license_number`. Invalid `severity_level` or any non-positive `event_category_id` returns action_value '1'.

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_incremental_events","parameters":[{"name":"last_event_id","value":"98765432"},{"name":"license_number","value":"AB-123-CD"},{"name":"severity_level","value":2},{"name":"event_category_id","value":"1,2,3"}]}}'
Body
{
  "action": {
    "name": "get_incremental_events",
    "parameters": [
      {
        "name": "last_event_id",
        "value": "98765432"
      },
      {
        "name": "license_number",
        "value": "AB-123-CD"
      },
      {
        "name": "severity_level",
        "value": "2"
      },
      {
        "name": "event_category_id",
        "value": "1,2,3"
      }
    ]
  }
}

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_incremental_events",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "event_id": "98765433",
          "vehicle_id": "555",
          "license_number": "AB-123-CD",
          "vin": "1HGCM82633A004352",
          "time": "2026-04-27T08:06:00Z",
          "event_type_id": "12",
          "event_type_description": "Harsh Braking",
          "event_category_id": "3",
          "event_category_description": "Driving Behavior",
          "severity": "2",
          "spn": "100",
          "fmi": "5",
          "source": "ECM",
          "start_latitude": "32.0901000",
          "start_longitude": "34.8000000",
          "end_time": "2026-04-27T08:06:06Z",
          "end_latitude": "32.0902000",
          "end_longitude": "34.8002000",
          "speed": "54.30",
          "direction": "183",
          "driver_id": "789",
          "driver_name": "John Doe",
          "driver_code": "DRV-789",
          "worker_id": "W-789"
        }
      ]
    }
  }
}