Fill any PDF form via API, including scans

import { readFile, writeFile } from "node:fs/promises";

const API = process.env.FORMFILL_API_URL!;
const auth = { Authorization: `Bearer ${process.env.FORMFILL_API_KEY}` };

// 1. Upload the PDF
const form = new FormData();
form.append("file", new Blob([await readFile("form.pdf")], { type: "application/pdf" }), "form.pdf");
const file = await (await fetch(`${API}/files/upload`, { method: "POST", headers: auth, body: form })).json();

// 2. Fill it
const res = await fetch(`${API}/edit`, {
  method: "POST",
  headers: { ...auth, "Content-Type": "application/json", "Idempotency-Key": crypto.randomUUID() },
  body: JSON.stringify({
    file: { id: file.id },
    config: { instructions: "Fill the form for Erika Mustermann, born 12.08.1990 in Musterstadt, living at Musterstraße 1, 12345 Musterstadt. Sign with her name and today's date.", advancedOptions: { flattenPdf: true } },
  }),
});
const run = await res.json();
if (!res.ok) throw new Error(`${run.code}: ${run.message}`);
if (run.status === "FAILED") throw new Error(`${run.failureReason}: ${run.failureMessage}`);
console.log(run.output.filledValues, run.output.review);

// 3. Download (link valid for 15 minutes)
const pdf = await fetch(run.output.editedFile.presignedUrl);
await writeFile("filled.pdf", Buffer.from(await pdf.arrayBuffer()));

import os, uuid, requests

API = os.environ["FORMFILL_API_URL"]
AUTH = {"Authorization": f"Bearer {os.environ['FORMFILL_API_KEY']}"}

# 1. Upload the PDF
with open("form.pdf", "rb") as f:
    file = requests.post(f"{API}/files/upload", headers=AUTH,
                         files={"file": ("form.pdf", f, "application/pdf")}, timeout=60).json()

# 2. Fill it
res = requests.post(
    f"{API}/edit",
    headers={**AUTH, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "file": {"id": file["id"]},
        "config": {
            "instructions": "Fill the form for Erika Mustermann, born 12.08.1990 in Musterstadt, living at Musterstraße 1, 12345 Musterstadt. Sign with her name and today's date.",
            "advancedOptions": {"flattenPdf": True},
        },
    },
    timeout=300,
)
res.raise_for_status()
run = res.json()
if run["status"] == "FAILED":
    raise RuntimeError(f"{run['failureReason']}: {run['failureMessage']}")

# 3. Download (link valid for 15 minutes)
pdf = requests.get(run["output"]["editedFile"]["presignedUrl"], timeout=60)
with open("filled.pdf", "wb") as f:
    f.write(pdf.content)