Form Filling Overview

Start here for Form filling: when to use structured medical forms, Form filling APIs vs the Form filling SDK, templates, and integration paths

Suki Form filling capabilities let you fill the medical forms hospitals already use from the visit conversation. Your application captures the visit audio, and Suki maps what was said into the form fields. Those forms can be Suki Medical form templates (Suki-defined) or partner-defined, hospital-specific medical forms. Your application can then review, edit, and save the structured data to your EHR or use it in downstream workflows.

Choose an SDK or API to build your workflow, then build the minimum path with the Quickstart guides. Add form template context and webhooks after that works.

Use Form filling when you need filled medical forms, not a full clinical note.

Ambient documentation turns the visit conversation into a structured clinical note. Form filling maps that conversation into field values on the forms you select for the session. Those forms can be Suki Medical form templates, partner-defined schemas on Form filling APIs, or both.

When to use Form filling

Choose Form filling when you need:

• Structured medical forms from visit conversation without generating a full ambient clinical note.
• Form output you control in your application (display, edit, validate, or send elsewhere).
• Full control with Form filling REST APIs and the shared Partner WebSocket for audio.

Related guides

Form Filling Guide

Capabilities, common use cases, how Form filling works, and Form filling Partner APIs.

Form Filling SDK

Embed Form filling in your web app with Suki’s hosted interface and structured results in your callbacks.

Mobile SDK Form Filling

Run a headless Form filling session on iOS with SukiAmbientCore (sessionType: .formFilling).

Form Filling API Basic Usage

Step-by-step Partner API workflow: create a session, seed context, stream audio, end the session, and retrieve structured data.

Dynamic Form filling

Use your own medical form layouts(schemas) alone or mixed with template IDs in the same session.

Resources

Refer to these guides when you are ready to integrate:

Form Filling APIs Overview

REST endpoints for sessions, context, structured data, feedback, and templates.

Suki Medical Form Templates API

List Suki-defined templates and field definitions for session context.

Medical form templates

Suki publishes a set of Medical form templates you can bind with form_template_id. The following table lists common medical forms templates available. Call the Info API for the template_id values enabled for your account.

Template	Type	Description
Vitals	VITALS_ASSESSMENT	Captures vital signs, oxygen delivery, and pain scores.
Neuro	NEURO_ASSESSMENT	Captures neurological status, orientation, pupils, strength, and sensation.
Skin	SKIN_ASSESSMENT	Captures skin integrity, wounds, dressings, and interventions.
Respiratory	RESPIRATORY_ASSESSMENT	Captures breathing, lung sounds, oxygen use, and respiratory symptoms.
Cardiac	CARDIAC_ASSESSMENT	Captures heart rhythm, circulation, edema, chest pain, and vascular access.
GI	GASTRO_INTESTINAL_ASSESSMENT	Captures abdominal findings, diet tolerance, bowel activity, and GI symptoms.
GU	GENITO_URINARY_ASSESSMENT	Captures urinary output, voiding, catheter care, and related symptoms.
MSK	MSK_ASSESSMENT	Captures mobility, strength, gait, range of motion, and joint findings.
Intake and output	IO_ASSESSMENT	Tracks fluid intake and output for fluid balance monitoring.

Refer to the Form filling templates guide for how templates work, and the Suki Medical form templates API for each template_id and full schema.

If Suki Medical form templates do not cover the forms you need, Form filling APIs also support partner-defined schemas (Dynamic Form filling). You can use schemas alone or together with Suki templates in the same session. Refer to Dynamic Form filling for more information.

Next steps

Form filling templates - Learn how Suki Medical form templates work in a session.

Dynamic Form filling - Use partner-defined forms instead of, or mixed with, Suki templates.

Form filling basic usage - Create a session, seed context, stream audio, and retrieve structured data.