Fill Form

from pulse import Pulse

client = Pulse(api_key="YOUR_API_KEY")

result = client.form.fill(
    file_url="https://example.com/intake-form.pdf",
    instructions="Fill in patient name as Jane Doe, DOB 01/15/1990.",
)

print(f"form_id={result.form_id}")
print(f"fields_filled={result.fields_filled}")
print(f"credits_used={result.credits_used}")
print(f"download: {result.pdf_url}")

with open("intake-form.pdf", "rb") as f:
    result = client.form.fill(
        file=f,
        instructions="Fill in patient name as Jane Doe, DOB 01/15/1990.",
    )

detect = client.form.detect(file_url="https://example.com/intake-form.pdf")

# (Optional) edit detected cells locally, e.g. retype a misclassified cell
edited = []
for cell in detect.form_fields or []:
    if cell.text and cell.text.strip().lower() == "signature":
        cell.type = "signature"
    edited.append(cell)

result = client.form.fill(
    form_id=detect.form_id,
    instructions="Fill in patient name as Jane Doe, DOB 01/15/1990.",
    form_fields=edited,  # omit to use the cached cells from detect
)

import time

submission = client.form.fill(
    file_url="https://example.com/big-form.pdf",
    instructions="Fill the form for Jane Doe ...",
    async_=True,  # SDK aliases the reserved keyword
)

while True:
    job = client.jobs.get_job(job_id=submission.job_id)
    if job.status in ("completed", "failed"):
        break
    time.sleep(2)

result = job.result  # same FormResult body as the sync flow
print(f"fields_filled={result['fields_filled']} pdf_url={result['pdf_url']}")

job_id = result.pdf_url.rstrip("/").split("/")[-2]
with open("filled.pdf", "wb") as out:
    for chunk in client.results.get_pdf(job_id=job_id):
        out.write(chunk)