Fill

POST /v1/fill — fill a converted document with values.

POST https://api.createafillablepdf.com/v1/fill

Fill a previously-converted document (by conversion_id) or a supplied fillable PDF with name→value pairs. Returns the filled PDF bytes. This is deterministic (no AI) and not page-metered.

Request

Content-Type: application/json

FieldRequiredTypeDescription
conversion_idone ofstringA conversion to fill (uses its stored fillable PDF + schema).
pdf_base64one ofstringA fillable PDF (base64) to fill directly. Requires fields.
fieldswith pdf_base64arrayThe field schema for pdf_base64.
valuesyesobjectMap of field name → value. Strings for text/date, booleans for checkboxes.
curl -X POST https://api.createafillablepdf.com/v1/fill \
  -H "Authorization: Bearer sk_live_•••" \
  -H "Content-Type: application/json" \
  -d '{
    "conversion_id": "c_123",
    "values": { "applicant_legal_name": "Dana Okonkwo", "is_us_citizen": true }
  }' --output filled.pdf

Response 200

application/pdf — the filled document as a binary download.