Skip to main content
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

ParameterRequiredTypeDescription
patient_idYesstringPatient user ID
date_fromNostring (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_toNostring (ISO 8601)Inclusive upper bound on StateTransition.triggered_at. Date-only values use timezone.
sinceNostring (ISO 8601)Deprecated alias for date_from.
timezoneNostring (IANA)Timezone for resolving date-only date_from / date_to (default: "America/New_York").
log_typeNostringWhen used with trace filters, resolves matching EventLog rows by type
trace_typeNostringResolve EventLog IDs by trace.object_type (e.g. "check_in_response")
trace_idNostringResolve EventLog IDs by trace.object_id (opaque id string)
statusNostringStatus filter: complete, pending, failed (default: complete)
limitNointegerMaximum number of transitions to return (max 200, default: 50)
formatNo"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"
    }
  ]
}