FreePDF Form Fields API — read every fillable field
Name, type, page, rect, value, options, required, read-only — per widget, one call.
PDF Form Fields inspects an existing PDF's AcroForm widgets and returns one entry per field: name, type, page, position, current value, choice options, and whether it's required or read-only. XFA-only forms (no fillable AcroForm fields) return a 422 rather than a silently empty list.
How does the PDF Form Fields API work?
One HTTP request from any language. Every ASHDOCS endpoint uses the same X-API-Key header.
curl -X POST 'https://api.ashdocs.com/api/v2/tools/pdf-form-fields' \ -H 'X-API-Key: ash_live_...' \ -F 'file=@form.pdf'
Common use cases
- →Building a dynamic fill UI from an unknown PDF
- →Auditing a form template before rollout
- →Detecting XFA-only forms before attempting to fill them
Frequently asked questions
How much does the PDF Form Fields API tool cost?+
Nothing — this is a local page operation with no rendering engine, OCR or AI behind it, so it runs free on every plan. Sandbox keys (prefix ash_test_) also never consume credits.
What is the endpoint URL for this tool?+
The endpoint is documented in the curl example on this page. All ASHDOCS endpoints share the base URL https://www.ashdocs.com and require an X-API-Key header.
Can I run this tool inside Make, Zapier, or n8n?+
Yes — through each platform's built-in HTTP mechanism (Make's HTTP module, Webhooks by Zapier, n8n's HTTP Request node). Nothing to install: point it at this exact endpoint with your X-API-Key header. See /integrations/make, /integrations/zapier or /integrations/n8n for step-by-step setup.
Does this tool support batch or scheduled runs?+
Yes. POST /api/v1/batch runs any tool over up to 50 files with a single credit ledger entry, and pipeline schedules let you trigger the same tool on a cron. Both are documented in /docs.