DocuTools API

Create a key in Settings → API keys (your email must be verified), then send it with every request. Keys are shown once; keep them secret. You can revoke a key at any time.

Authorization: Bearer dt_your_api_key

Each successful job uses the tool's credit cost: daily plan credits first, then purchased credits. Failed jobs are free. API and website jobs share the same limit of 100 jobs per hour per account. Uploaded files are processed in memory and are not stored.

POST https://docutools.net/api/v1/tools/{slug} with multipart/form-data: one or more files fields plus the tool's options as text fields. The response body is the result file. The headers X-Credits-Charged and X-Credits-Left show what the job cost and what you have left.

curl -X POST https://docutools.net/api/v1/tools/merge-pdf \
  -H "Authorization: Bearer $DOCUTOOLS_KEY" \
  -F "files=@first.pdf" \
  -F "files=@second.pdf" \
  -o merged.pdf

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

const form = new FormData()
form.append('files', new Blob([await readFile('report.pdf')]), 'report.pdf')
form.append('angle', '90')

const res = await fetch('https://docutools.net/api/v1/tools/rotate-pdf', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.DOCUTOOLS_KEY}` },
  body: form,
})
if (!res.ok) throw new Error((await res.json()).error)
await writeFile('rotated.pdf', Buffer.from(await res.arrayBuffer()))
console.log('Credits left:', res.headers.get('X-Credits-Left'))

import os, requests

res = requests.post(
    "https://docutools.net/api/v1/tools/compress-image",
    headers={"Authorization": f"Bearer {os.environ['DOCUTOOLS_KEY']}"},
    files={"files": open("photo.jpg", "rb")},
    data={"quality": "70"},
)
res.raise_for_status()
open("photo-small.jpg", "wb").write(res.content)

POST https://docutools.net/api/v1/workflow runs 2–6 tools in a row in one request. Send the input files plus a steps field with JSON; each step's result becomes the next step's input. The job costs the sum of the steps and counts as one job for the hourly limit. Credits are only used if every step succeeds. verify-stamp can only be the last step.

curl -X POST https://docutools.net/api/v1/workflow \
  -H "Authorization: Bearer $DOCUTOOLS_KEY" \
  -F "files=@part-1.pdf" -F "files=@part-2.pdf" \
  -F 'steps=[{"tool":"merge-pdf"},{"tool":"page-numbers","options":{"position":"bottom-right"}},{"tool":"verify-stamp","options":{"pages":"last"}}]' \
  -o contract.pdf -D headers.txt

Stamped results include an X-Stamp-Code header. Anyone can check the file at docutools.net/verify; only its fingerprint is compared, the file is not uploaded.

Share a PDF by link; every recipient gets a personal copy with its own hidden code. POST https://docutools.net/api/v1/share takes the PDF in file and optional fields title, expires (7, 30 or 90 days), maxCopies (1–500), maxDownloads (per recipient, 0 = no limit), and allowForward, printMark, notifyOwner (true/false, default true). Prices are shown on Tracked Share; copies are charged to the sender.

curl -X POST https://docutools.net/api/v1/share \
  -H "Authorization: Bearer $DOCUTOOLS_KEY" \
  -F "file=@proposal.pdf" -F "title=Q4 proposal" -F "expires=30" -F "maxDownloads=3"

{ "id": "cm…", "title": "Q4 proposal", "expiresAt": "…",
  "shareUrl": "https://docutools.net/s/…", "ownerCopyUrl": "https://docutools.net/api/share/copy/…" }

• GET /api/v1/share lists your shared documents.
• GET /api/v1/share/{id} returns the settings and every copy: label (A, Aa, Aa1 …), parent, recipient, downloads.
• POST /api/v1/share/{id}/revoke with {"copy":"Aa"} revokes a copy and everything forwarded from it.
• DELETE /api/v1/share/{id} stops sharing and deletes the stored file.
• POST /api/v1/share/trace with a found copy in file, or the code from a paper copy in code, returns the path from your original to that copy. Free.

GET https://docutools.net/api/v1/credits returns your available credits and the next daily reset.

{
  "total": 113,
  "daily": { "left": 63, "allowance": 100, "resetsAt": "2026-10-25T17:00:00.000Z" },
  "purchased": 50,
  "plan": { "name": "Standard", "interval": "month", "activeUntil": "2026-11-25T09:00:00.000Z" }
}

GET https://docutools.net/api/v1/tools lists the active tools with their slug, credit cost and options.

GET https://docutools.net/api/v1/status needs no key and returns operational, degraded or down with response times. Human-readable version: /status.

Errors return JSON like { "error": "…" }. No credits are used when a request fails.

Questions or need higher limits? Contact support.