Developer API
PDF merge API
Compare the documented operations, data handling and billing model of each service using a representative document. PennyPDF uses prepaid coins for paid tasks and provides several local browser tools for free. Check providers’ current documentation for their pricing and features.
PennyPDF's /v1/merge endpoint is priced at 0 coins. Upload any number of PDFs as a multipart form, receive the merged PDF back in the response body. Bookmarks from each source are preserved and offset. Up to 2 GB of combined input per request, 200 requests/minute per API key.
Current coin packs: Mini: $0.99 for 10 coins; Starter: $2.99 for 50 coins; Saver: $7.99 for 200 coins; Power: $19.99 for 600 coins; Pro: $49.99 for 2,000 coins; Dev: $199 for 10,000 coins. Coins do not expire. Local self-signing, merging, splitting, organizing and redaction are free. Paid tools show their coin cost before you run them.
Copy, paste, ship
Same bearer-token auth across every endpoint. Set PENNYPDF_API_KEY in your environment first.
curl -X POST https://api.pennypdf.com/v1/merge \
-H "Authorization: Bearer $PENNYPDF_API_KEY" \
-F "files[]=@part1.pdf" \
-F "files[]=@part2.pdf" \
-F "files[]=@part3.pdf" \
-o merged.pdfimport os, requests
files = [("files[]", open(p, "rb")) for p in ("part1.pdf", "part2.pdf", "part3.pdf")]
r = requests.post(
"https://api.pennypdf.com/v1/merge",
headers={"Authorization": f"Bearer {os.environ['PENNYPDF_API_KEY']}"},
files=files,
)
r.raise_for_status()
open("merged.pdf", "wb").write(r.content)
print(f"Spent {r.headers['X-Coins-Spent']} coins") # 0How it works
- 1Sign in at /dashboard/api and grab an API key (or email api@pennypdf.com for instant provisioning).
- 2POST your PDFs as multipart/form-data to /v1/merge.
- 3Receive the merged PDF in the response body. No polling, no webhooks, no coins debited.
Frequently asked
What's the actual cost at 10,000 merges per month?+
Current coin packs: Mini: $0.99 for 10 coins; Starter: $2.99 for 50 coins; Saver: $7.99 for 200 coins; Power: $19.99 for 600 coins; Pro: $49.99 for 2,000 coins; Dev: $199 for 10,000 coins. Coins do not expire. Local self-signing, merging, splitting, organizing and redaction are free. Paid tools show their coin cost before you run them.
How many files can I merge in one request?+
Up to 2 GB of combined input. No hard cap on file count below that — we've seen 500-file merges in production without issue. If one file is larger than 100 MB on its own, use the async variant (POST /v1/jobs/merge) which streams to R2.
What's the typical latency?+
90th percentile is 350 ms for a 20-page merge, 1.2 s for a 200-page merge, 4 s for a 1000-page merge. Merges run on the pre-warmed worker pool; cold starts aren't a factor.
What are the rate limits?+
200 requests/minute per API key, burst to 400. Higher limits on request — email api@pennypdf.com with your expected peak QPS and we'll bump you within a business day, no sales call.
Are bookmarks preserved?+
Yes. Every source PDF's bookmark tree is offset by the page count of earlier inputs and concatenated. The merged PDF's outline reflects the combined structure exactly as you'd expect.
Does /v1/merge support encrypted PDFs?+
Pass &passwords[] per input file in the same multipart payload. If a file can't be decrypted, the entire merge fails atomically — no partial output, no coins debited (which matters for the paid endpoints, not this one).
Why PennyPDF
- No subscription. Ever.
- Coins never expire — use them in 5 years.
- Client-side processing for 14 of 22 tools.
- No watermarks at any tier.
- Per-operation pricing, shown before you click.
- Same coins for web + public API.