Developers

Public PDF API for humans and agents on PDF123 (pdf123.xyz). Authenticate with X-API-KEY. Errors use RFC 7807-style application/problem+json (fields: type, title, status, detail, code, hint). High-intent endpoints include the Repair PDF API (POST /api/v1/misc/repair) and OCR PDF API (POST /api/v1/misc/ocr-pdf), plus merge, pipeline, and the rest of the OpenAPI catalog.

OpenAPI

• /v1/openapi.json
• /swagger-ui
• Error codes
• MCP

Pipeline

POST /api/v1/pipeline with multipart fileInput and steps (JSON array of {op, params}). Example: merge → watermark → compress. Send Idempotency-Key to safely retry.

Rate limits

Responses include X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. On 429, also Retry-After.

API keys

جارٍ التحقق من جلستك…

SDK, CLI, MCP & Skill

• TypeScript SDK @pdf123/sdk, the pdfx CLI (@pdf123/cli) and a local stdio MCP server (@pdf123/mcp), all calling this API. See repo sdk/, cli/, mcp/.
• Agent skills (Claude Code, Codex, Cursor, …): the catalog skill is /skills/pdf123.md, and every tool page offers its own SKILL.md (full list). Source: repo skills/.
  مهارة
• Self-host · Enterprise