A form. A conversation. A finished document.
Watch the paperwork come together.
Start from a conversation, supply JSON, or explore the API. One template, three ways to fill a two-page PDF. Synthetic data. No account needed. Your edits stay in this tab.
01 / The conversation
Start with the details.
A two-page packet with all 21 fields supplied.
My name is Taylor Example, date of birth 03/15/1980. My phone is 555-0198 and my email is taylor@example.com. I live at 100 Example Lane, Austin, postal code 78701. Please use Email as my preferred contact method. Reason for visit: Persistent headache and fatigue. Duration: 1-3 days. Visit priority: Routine. I agree to follow-up care. Medications and history: Daily vitamin supplement. No prescription medication. My allergy is Penicillin. My insurer is Example Health and my policy number is DEMO-2048. My emergency contact is Casey Example at 555-0140. Morning appointments work best. I allow appointment contact. I have reviewed my information.
01 / Structured data
Your data becomes the document.
Edit the values below. Valid JSON updates the PDF automatically. Omitted fields stay blank; use true / false for checkboxes and null for unknown values.
Ready to edit. Only valid values are applied to the PDF.
Field names & allowed values
patient_name· textdate_of_birth· textphone_number· textemail· textaddress· textcity· textpostal_code· textcontact_method· choice: Email / Phone / SMSchief_complaint· multilinesymptom_duration· choice: 1-3 days / 4-7 days / More than a weekvisit_priority· choice: Routine / Urgentfollow_up_agreed· booleanmedications· multilineallergies· multilineinsurance_provider· textpolicy_number· textemergency_contact· textemergency_phone· textpreferred_appointment· choice: Morning / Afternoon / Eveningconsent_contact· booleanconsent_information· boolean
01 / Integrate your template
Same fields. Your own workflow.
These are copyable API examples, not requests sent by this demo. On your deployment, publish a template and create a team API key. Keep the key on your server. The bundled demo packet is a local example, not a published API template.
1. Find published templates · shell
# Replace these placeholders with your deployment and team API key.
export FILLFORM_URL="https://your-fillform.example"
export FILLFORM_API_KEY="YOUR_TEAM_API_KEY"
# List published templates and their field names.
curl "$FILLFORM_URL/api/v1/templates" \
-H "Authorization: Bearer $FILLFORM_API_KEY"2. Fill a template · shell
# Save the JSON tab content as payload.json.
# Use a published template ID returned by the list endpoint.
export TEMPLATE_ID="YOUR_PUBLISHED_TEMPLATE_ID"
curl --fail-with-body "$FILLFORM_URL/api/v1/templates/$TEMPLATE_ID/fill" \
-H "Authorization: Bearer $FILLFORM_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @payload.json \
--output response.jsonpayload.json · current values
{
"values": {
"patient_name": "Taylor Example",
"date_of_birth": "03/15/1980",
"phone_number": "555-0198",
"email": "taylor@example.com",
"address": "100 Example Lane",
"city": "Austin",
"postal_code": "78701",
"contact_method": "Email",
"chief_complaint": "Persistent headache and fatigue",
"symptom_duration": "1-3 days",
"visit_priority": "Routine",
"follow_up_agreed": true,
"medications": "Daily vitamin supplement. No prescription medication.",
"allergies": "Penicillin",
"insurance_provider": "Example Health",
"policy_number": "DEMO-2048",
"emergency_contact": "Casey Example",
"emergency_phone": "555-0140",
"preferred_appointment": "Morning",
"consent_contact": true,
"consent_information": true
}
}Response shape · abbreviated
{
"fileName": "filled-patient-intake.pdf",
"pdfBase64": "<base64-encoded PDF>",
"extraction": {
"fields": [
{
"name": "patient_name",
"value": "Taylor Example",
"confidence": 1,
"source": "provided values"
}
],
"unmapped_notes": []
},
"report": {
"fields": [
{
"name": "patient_name",
"type": "text",
"value": "Taylor Example",
"confidence": 1,
"status": "filled",
"source": "provided values"
}
],
"warnings": [],
"unmapped_notes": []
}
}3. Save the PDF · Node.js
# Node.js: decode the returned PDF.
const fs = require("node:fs");
const response = JSON.parse(fs.readFileSync("response.json", "utf8"));
if (!response.pdfBase64) throw new Error(response.error || "No PDF returned");
fs.writeFileSync(response.fileName, Buffer.from(response.pdfBase64, "base64"));401: invalid or missing API key · 404: template unavailable or unpublished · 429: rate limit; respect Retry-After. The fill endpoint returns JSON, not a PDF stream.
Template field catalog · 21 fields
patient_name· textdate_of_birth· textphone_number· textemail· textaddress· textcity· textpostal_code· textcontact_method· choice · Email / Phone / SMSchief_complaint· multilinesymptom_duration· choice · 1-3 days / 4-7 days / More than a weekvisit_priority· choice · Routine / Urgentfollow_up_agreed· booleanmedications· multilineallergies· multilineinsurance_provider· textpolicy_number· textemergency_contact· textemergency_phone· textpreferred_appointment· choice · Morning / Afternoon / Eveningconsent_contact· booleanconsent_information· boolean
02 / Review & refine
Your edits. On the page.
Select “Fill example” to populate the PDF and open the field editor.
03 / The document
Patient intake packet
2 pages · 21 fields · Text, options & checkboxes
Opening sample document…
Watch the fields fill, then make it your own.
Download blank sample