PDF.co API Documentation
This is the complete API documentation for connecting to the PDF.co API using MindCloud's Universal API. If you are new to MindCloud, start with the Introduction to see how one API can sit in front of many different apps.
MindCloud is an integration company that offers one normalized API to access 3,100+ apps from a single place. It cleans up provider-specific quirks, keeps requests and responses consistent, and centralizes authentication so you do not need to manage separate flows for every app. Browse other apps.
Meet PDF.co: Convert PDFs, extract data, merge files, and generate barcodes. Keep reading to get started.
Quickstart
Before you run your first PDF.co request, you need three things:
- A MindCloud account — sign in or create an account at MindCloud.
- A MindCloud API Key — create one in API Keys. Keep it on your server.
- At least one PDF.co connection — create or choose one in Connections. Note its
connectionId.
Every PDF.co action uses the same URL pattern:
https://connect.mindcloud.co/v1/universal/pDFco/latest/actions/{actionSlug}You need a MindCloud API Key and a PDF.co connection. Then call an action such as Check Background Job Status:
curl --request GET \
--url "https://connect.mindcloud.co/v1/universal/pDFco/latest/actions/check-background-job-status" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--get \
--data-urlencode "connectionId=$CONNECTION_ID"Every response comes back in the same envelope, with your rows in a data array:
{
"success": true,
"data": [
{ "id": "1042", "name": "Ava" }
],
"meta": {}
}After your first request works, use Shape your requests to control arguments, pagination, filtering, fields, and errors.
Authentication
Authentication has two layers. Your MindCloud API Key authenticates the request to MindCloud, sent as a Bearer token in the Authorization header. The connectionId selects the connected PDF.co account that should run the action. MindCloud stores and refreshes the PDF.co credentials behind that connection, so you never send provider tokens with your requests.
Pass connectionId in the query string for GET and DELETE actions, and in the JSON body for POST, PUT, and PATCH actions. Keep your MindCloud API Key on your server; do not ship it in browser code, mobile apps, public repositories, or logs.
PDF.co actions
All 34 published actions for this PDF.co version. Each page documents the endpoint, arguments, and response controls.
- PUTAdd Content to PDF
- PUTAdd Password to PDF
- GETCheck Background Job Status
- GETClassify Document
- PUTCompress PDF
- POSTConvert HTML to PDF
- DELETEDelete Temporary File
- POSTExcel to CSV
- POSTExcel to PDF
- GETFind Text in PDF
- POSTGenerate Barcodes
- GETGet Account Balance
- GETGet PDF Form Fields Info
- GETGet PDF Info
- GETList All Templates
- PUTMake PDF Text Searchable
- POSTMerge PDF
- POSTParse Document
- GETParse Invoice with AI
- PUTPDF Delete Pages
- GETPDF to CSV
- GETPDF to HTML
- GETPDF to JPG
- POSTPDF to JSON
- GETPDF to JSON with AI
- GETPDF to PNG
- POSTPDF to Text
- GETPDF to XLSX
- GETRead Barcodes
- PUTRemove Password from PDF
- PUTRotate Selected Pages
- POSTSplit PDF
- POSTUpload File from URL
- POSTUpload File Using Base64
Related apps
More Business Intelligence apps on the Universal API, behind the same REST shape. Or browse all apps.