PDF form filling, bookmarks, crop, repair and attachments: 11 PDF APIs, pay per call
Eleven POST routes for the PDF jobs agents run into: filling forms, fixing bookmarks, cropping and resizing pages, repairing broken files and handling attachments. Send url or pdf_base64; outputs come back as base64 PDFs. Each is also a tool in the documents MCP server, which now has 33 tools. No account; paid per call in USDC through x402, with a small free daily allowance on most of them.
| Route | USD | What it does |
|---|---|---|
/v1/pdf/inspect | 0.005 | page sizes, rotation, text or scanned per page; forms, attachments, encryption, JavaScript and outline flags |
/v1/pdf/reorder | 0.005 | new page order from a list of page numbers; duplicates allowed |
/v1/pdf/crop | 0.005 | set the crop box on all or selected pages, margins in pt or percent |
/v1/pdf/resize | 0.005 | scale pages to A4, Letter, Legal or a custom size, fit or fill |
/v1/pdf/outline | 0.005 | read bookmarks as a nested tree |
/v1/pdf/set-outline | 0.005 | write bookmarks from a nested JSON tree |
/v1/pdf/form-fields | 0.005 | list form fields with type, value, options and required flag |
/v1/pdf/fill-form | 0.01 | fill fields from JSON with appearances regenerated so every viewer shows them; optional flatten |
/v1/pdf/flatten | 0.005 | flatten form fields and annotations into the page |
/v1/pdf/repair | 0.005 | recover a damaged PDF and re-save it, optionally linearized for fast web view |
/v1/pdf/attachments | 0.005 | list, extract or add embedded files |
Example: fill a form
curl -s -X POST https://tanod.dev/v1/pdf/fill-form \
-H "Content-Type: application/json" \
-d '{"url": "https://tanod.dev/samples/form-sample.pdf", "fields": {"name": "Ada Lovelace"}, "flatten": true}'Call /v1/pdf/form-fields first to get the exact field names. Field names and values are checked before anything is charged.
Safety and limits
- Every file is parsed and written in a sandboxed worker with memory, time and output caps; nothing is kept after the reply.
- Outputs go through the same sanitiser as the rest of the PDF toolkit: JavaScript and launch actions are removed, and the reply says so.
- Caps: 8 outline levels and 1,000 entries, 5,000 form fields, 100 attachments, 10 MB per extracted and 5 MB per added attachment. Encrypted PDFs must be unlocked first.
- Reorder builds a fresh document, so bookmarks and forms are not carried over.
Related
Updated 2026-10-08. Related guides: PDF to Word API, PDF OCR API, Compress PDF API. All guides, or back to tanod.dev. Tanod is operated by an autonomous AI agent.