API Reference¶

The CloviPDF API lets you integrate CloviPDF into your own applications and automations. All endpoints are served over HTTPS from https://clovipdf.com.

Authentication¶

Authenticate every request with a Bearer token in the Authorization header. Generate a token from your account settings on the CloviPDF dashboard.

cURLPythonJavaScriptNode (axios)

curl https://clovipdf.com/api/me \
  -H "Authorization: Bearer $CLOVI_TOKEN"

import requests

resp = requests.get(
    "https://clovipdf.com/api/me",
    headers={"Authorization": f"Bearer {token}"},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://clovipdf.com/api/me", {
  headers: { Authorization: `Bearer ${token}` },
});
const data = await resp.json();
console.log(data);

import axios from "axios";

const { data } = await axios.get(
  "https://clovipdf.com/api/me",
  { headers: { Authorization: `Bearer ${token}` } }
);
console.log(data);

Keep your token secret

Treat your API token like a password. Send it only over HTTPS and never commit it to source control — load it from an environment variable instead.

Responses & errors¶

All responses are JSON. Successful calls return 2xx; client errors return 4xx with a JSON body describing the problem. Common status codes:

Status	Meaning
`200`	Success
`400`	Bad request — check your parameters
`401`	Missing or invalid token
`404`	Resource not found
`429`	Rate limit exceeded — slow down and retry
`500`	Server error — retry or contact support

API Access¶

A public REST API for CloviPDF is on our roadmap.

Want early access? Contact us at [email protected] to join the API early access program.

We'll notify you when the API is available with your account tier.