PDF.co PDF Conversion API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as x-api-key (ApiKeyAuth).
By default, every request must be authenticated.
Paths & Operations 21
Across 21 paths, the API surfaces 21 operations — 2 GET, 19 POST. Each is listed below with its method, path, parameters, and response codes.
The contract defines 29 schemas that model the data the API accepts and returns. Each schema is shown below with its type and property counts.
customscript
string
custom script to execute on page load
rendertimeout
number
timeout for rendering in milliseconds (optional)
url
string
URL to the source file [url attribute](/api-reference/url-input-and-request-limits).
name
string
File name for generated output.
timeout
number
Timeout for output links in seconds
mediatype
string
Controls how content is rendered when converting to PDF. Options: print (uses print styles), screen (uses screen styles), none (no media type applied).
margins
string
Set custom margins, overriding CSS default margins. Specify the margins in the format {top} {right} {bottom} {left}. You can usepx,mm,cmorinunits. Also, you ca…
inline
boolean
Set to true to return results inside the response. Otherwise, the endpoint will return a URL to the output file generated.
footer
string
Set this to can add user definable HTML for the footer to be applied on every page bottom. The format is html.
templatedata
string
please set to string converted from JSON with data for Mustache template or leave empty if no template is used
header
string
Set this to can add user definable HTML for the header to be applied on every page header. The format is html.
rect
string
Defines coordinates for extraction. Use[PDF Edit Add Helper](https://app.pdf.co/pdf-edit-add-helper) to get or measure PDF coordinates. The format is {x} {y} {…
async
boolean
Set async to true for long processes to run in the background, API will then return a jobId which you can use with the [Background Job Check endpoint](/api-ref…
donotwaitfullload
boolean
Controls how thoroughly the converter waits for a page to load before converting HTML to PDF --- false waits for full page load, while true speeds up conversio…
unwrap
boolean
Unwrap lines into a single line within table cells in provided PDF documents. This is only applicable when lineGrouping is set to 1.
httppassword
string
HTTP auth password if required to access source URL.
lang
string
Set the language for OCR (text from image) to use for scanned PDF, PNG, and JPG documents input when extracting text. see [Language Support](/api-reference/lan…
password
string
Password for the PDF file.
papersize
Specifies the paper size. Accepts standard sizes like 'Letter', 'Legal', 'Tabloid', 'Ledger', 'A0'–'A6'. You can also set a custom size by providing width and…
file
string
The path to the local file to be uploaded.
printbackground
boolean
Set to false to disable background colors and images are included when generating PDFs from HTML/URL
profiles
string
Profiles are used configure extra options for specific API endpoints and may be unique to an API. For more information, see [Profiles](/api-reference/profiles)…
linegrouping
string
Controls how lines of text are grouped when extracting data from a PDF. Line grouping within table cells. The available modes are: 1, 2, 3. For more informatio…
pages0
string
Page indices/ranges (0-based). Items are comma-separated. Each item is one of: N (e.g., 0), N-M (e.g., 3-7), N- (open-ended, e.g., 10-), or !N (reverse index;…
legacyrendition
boolean
use legacy rendition (optional)
httpusername
string
HTTP auth user name if required to access source URL.
templateid
number
Set ID of HTML template to be used. View and manage your templates at HTML to PDF Templates.
orientation
string
Sets the document orientation. Options: Portrait for vertical layout, and Landscape for horizontal layout.
expiration
number
Sets the expiration time for the output link, in minutes. After this period, generated output file(s) are automatically deleted from [PDF.co Temporary Files St…
Specification
The full machine-readable OpenAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of PDF.co PDF Conversion API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.