get_events - Olira

Get completed events for the patient (persisted as StateTransition documents). When trace_type, trace_id, or log_type are supplied the server first resolves matching EventLog IDs and returns the rows driven by those logs.

Parameters

Parameter	Required	Type	Description
`patient_id`	Yes	`string`	Patient user ID
`date_from`	No	`string` (ISO 8601)	Inclusive lower bound on `StateTransition.triggered_at` (and `EventLog.timestamp` when resolving via `log_type` / trace filters). Date-only values use `timezone`.
`date_to`	No	`string` (ISO 8601)	Inclusive upper bound on `StateTransition.triggered_at`. Date-only values use `timezone`.
`since`	No	`string` (ISO 8601)	Deprecated alias for `date_from`.
`timezone`	No	`string` (IANA)	Timezone for resolving date-only `date_from` / `date_to` (default: `"America/New_York"`).
`log_type`	No	`string`	When used with trace filters, resolves matching `EventLog` rows by `type`
`trace_type`	No	`string`	Resolve EventLog IDs by `trace.object_type` (e.g. `"check_in_response"`)
`trace_id`	No	`string`	Resolve EventLog IDs by `trace.object_id` (opaque id string)
`status`	No	`string`	Status filter: `complete`, `pending`, `failed` (default: `complete`)
`limit`	No	`integer`	Maximum number of transitions to return (max 200, default: `50`)
`format`	No	`"raw"` or `"markdown"`	Output format (default: `raw`). `"pretty"` is accepted as a deprecated alias for `"markdown"`.

Example output

Illustrative: each item may include log_payload for the originating clinical payload.

{
  "events": [
    {
      "log_type": "symptom_report",
      "triggered_at": "2026-03-18T10:15:00Z",
      "status": "complete"
    }
  ]
}