API DOCS

Konomic API

Programmatic access to all 30+ Konomic PDF tools. Simple REST API, JSON or multipart, available on the Business tier.

Get an API key See integrations

Quick start

Every endpoint follows the same pattern: POST a file, get back a download URL or the result inline.

# Compress a PDF

curl -X POST https://konomic.io/api/v1/compress-pdf \

-H "Authorization: Bearer YOUR_API_KEY" \

-F "file=@document.pdf" \

-F "quality=medium"

# Response

{

"task_id": "abc123",

"status": "completed",

"download_url": "https://konomic.io/files/abc123/result.pdf",

"size_before": 2_456_789,

"size_after": 891_234

}

Authentication

All API requests require an API key passed via the Authorization header. Get your key from the dashboard after upgrading to the Business tier.

Authorization: Bearer kn_live_xxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secret. If it leaks, rotate it immediately from the dashboard. Each key is scoped to one Konomic account and has full access to all endpoints.

Rate limits

Tier	Requests/min	Operations/day	Max file size
Business	120	Unlimited	500 MB
Enterprise	600	Unlimited	2 GB

When you hit a rate limit, you get a 429 Too Many Requests response with a Retry-After header. Implement exponential backoff in your client.

All endpoints

POST/api/v1/merge-pdfMerge multiple PDFs into one

POST/api/v1/split-pdfSplit PDF by pages or ranges

POST/api/v1/compress-pdfReduce PDF file size

POST/api/v1/rotate-pdfRotate PDF pages

POST/api/v1/ocrRun OCR on a PDF

POST/api/v1/pdf-to-wordConvert PDF to .docx

POST/api/v1/pdf-to-imageConvert PDF pages to PNG/JPG

POST/api/v1/pdf-to-excelExtract tables to .xlsx

POST/api/v1/image-to-pdfCombine images into PDF

POST/api/v1/protect-pdfAdd password protection

POST/api/v1/unlock-pdfRemove password from PDF

POST/api/v1/redact-pdfPermanently remove content

POST/api/v1/add-watermarkStamp text or image

POST/api/v1/page-numbersAdd page numbers / Bates labels

POST/api/v1/flatten-pdfFlatten layers and annotations

POST/api/v1/sign-requestsSend PDF for e-signature

GET/api/v1/sign-requestsList your sign requests

GET/api/v1/sign-requests/{id}Get sign request status

Error responses

Code	Meaning	When it happens
400	Bad Request	Missing required field, invalid file format
401	Unauthorized	Missing or invalid API key
403	Forbidden	Tier limit exceeded
413	Payload Too Large	File exceeds tier max size
422	Unprocessable Entity	PDF is corrupt or password-protected
429	Too Many Requests	Rate limit hit — retry with backoff
500	Server Error	Something broke on our end — retry later

Code examples

Python

import requests

files = {"file": open("doc.pdf", "rb")}

headers = {"Authorization": "Bearer kn_live_xxx"}

r = requests.post(

"https://konomic.io/api/v1/compress-pdf",

files=files, headers=headers,

data={"quality": "medium"}

)

print(r.json()["download_url"])

Node.js

import FormData from "form-data";

import fs from "fs";

const form = new FormData();

form.append("file", fs.createReadStream("doc.pdf"));

form.append("quality", "medium");

const res = await fetch(

"https://konomic.io/api/v1/compress-pdf",

{ method: "POST", body: form,

headers: { Authorization: "Bearer kn_live_xxx" } }

);

console.log(await res.json());

Get an API key

Available on the Business tier — $14.99/month. 100 sign requests included.

See pricing

Quick start

Every endpoint follows the same pattern: POST a file, get back a download URL or the result inline.

# Compress a PDF

curl -X POST https://konomic.io/api/v1/compress-pdf \

-H "Authorization: Bearer YOUR_API_KEY" \

-F "file=@document.pdf" \

-F "quality=medium"

# Response

{

"task_id": "abc123",

"status": "completed",

"download_url": "https://konomic.io/files/abc123/result.pdf",

"size_before": 2_456_789,

"size_after": 891_234

}

Authentication

All API requests require an API key passed via the Authorization header. Get your key from the dashboard after upgrading to the Business tier.

Authorization: Bearer kn_live_xxxxxxxxxxxxxxxxxxxxxxxx

Keep your API key secret. If it leaks, rotate it immediately from the dashboard. Each key is scoped to one Konomic account and has full access to all endpoints.

Tier

Requests/min

Operations/day

Max file size

Business

120

Unlimited

500 MB

Enterprise

600

Unlimited

2 GB

All endpoints

POST/api/v1/merge-pdfMerge multiple PDFs into one

POST/api/v1/split-pdfSplit PDF by pages or ranges

POST/api/v1/compress-pdfReduce PDF file size

POST/api/v1/rotate-pdfRotate PDF pages

POST/api/v1/ocrRun OCR on a PDF

POST/api/v1/pdf-to-wordConvert PDF to .docx

POST/api/v1/pdf-to-imageConvert PDF pages to PNG/JPG

POST/api/v1/pdf-to-excelExtract tables to .xlsx

POST/api/v1/image-to-pdfCombine images into PDF

POST/api/v1/protect-pdfAdd password protection

POST/api/v1/unlock-pdfRemove password from PDF

POST/api/v1/redact-pdfPermanently remove content

POST/api/v1/add-watermarkStamp text or image

POST/api/v1/page-numbersAdd page numbers / Bates labels

POST/api/v1/flatten-pdfFlatten layers and annotations

POST/api/v1/sign-requestsSend PDF for e-signature

GET/api/v1/sign-requestsList your sign requests

GET/api/v1/sign-requests/{id}Get sign request status

Error responses

Code	Meaning	When it happens
400	Bad Request	Missing required field, invalid file format
401	Unauthorized	Missing or invalid API key
403	Forbidden	Tier limit exceeded
413	Payload Too Large	File exceeds tier max size
422	Unprocessable Entity	PDF is corrupt or password-protected
429	Too Many Requests	Rate limit hit — retry with backoff
500	Server Error	Something broke on our end — retry later

Code examples

Python

import requests

files = {"file": open("doc.pdf", "rb")}

headers = {"Authorization": "Bearer kn_live_xxx"}

r = requests.post(

"https://konomic.io/api/v1/compress-pdf",

files=files, headers=headers,

data={"quality": "medium"}

)

print(r.json()["download_url"])

Node.js

import FormData from "form-data";

import fs from "fs";

const form = new FormData();

form.append("file", fs.createReadStream("doc.pdf"));

form.append("quality", "medium");

const res = await fetch(

"https://konomic.io/api/v1/compress-pdf",

{ method: "POST", body: form,

headers: { Authorization: "Bearer kn_live_xxx" } }

);

console.log(await res.json());

Get an API key

Available on the Business tier — $14.99/month. 100 sign requests included.

See pricing