Pre-visit summaries

Pre-visit summaries let you collect a structured patient history before the appointment. SNOW processes the responses and delivers a ready-to-read clinical brief to your doctor.

Two modes

Patient-driven

Send a link to the patient. They fill in their history from any device — no login, no app download.

Use POST /v1/sessions/previsit/patient

Provider-driven

Staff fills the form in-clinic on a tablet or PC — while the patient is present.

Use POST /v1/sessions/previsit/provider

Both modes return the same response shape and fire the same webhook events.

The flow

1. Create a session — call POST /v1/sessions/previsit/patient or /provider. You get a session_url back in ~200ms.
2. Deliver the URL — send it to the patient via SMS / WhatsApp, or open it on a staff device.
3. Patient / staff fills the form — SNOW’s adaptive questionnaire, voice input, and document upload. No login required.
4. Webhook fires — when processing is done, we POST session.completed to your registered webhook endpoint.
5. Fetch the result — GET /v1/sessions/{id} returns the structured pre-consult brief, with a safety block.

Specialty variants

The default questionnaire covers general OPD. Use template_code in the request body to select a specialty:

template_code	Specialty
previsit_general_v1	General OPD (default)
previsit_anc_v1	Antenatal care (ANC)

More specialty templates are added on request.

Webhook events

All pre-visit sessions fire these events:

Event	When
session.created	Immediately on POST — confirms receipt
session.processing	Worker picks up the job
session.completed	Summary ready — fetch result from GET /v1/sessions/:id
session.failed	Processing failed — error_code + retriable in payload

See Webhook reference for the full payload shape and signature verification.