FolioKit API

The same self-hosted engines that power the website are available over REST. Authenticate with a Bearer JWT or an X-API-Key header.

Interactive reference: Swagger UI · OpenAPI JSON

Create a job

curl -X POST https://pdf.mathsquick.com/api/v1/pdf/merge \
  -H "X-API-Key: fk_..." \
  -F "files=@a.pdf" -F "files=@b.pdf"

Poll status

GET /api/v1/jobs/{id}
# queued | processing | completed | failed | expired | cancelled

Rate limits

Guest traffic is throttled per IP. API keys follow plan limits (free / developer / pro). Billing is prepared but not activated in version one.

Errors

User-facing messages stay generic. Technical details stay in server logs. Failed jobs include an error reference ID.