Skip to main content
POST
/
api
/
v1
/
convert-to-pdf
Convert to PDF
curl --request POST \
  --url https://app.dumplingai.com/api/v1/convert-to-pdf \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "inputMethod": "url",
  "file": "https://example.com/brochure.html"
}
'
{
  "url": "<string>"
}

​
Description

This endpoint converts various document formats to PDF. It supports a wide range of input formats including office documents, images, and web formats.

​
Endpoint

POST https://app.dumplingai.com/api/v1/convert-to-pdf

​
Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

​
Request Body

{
  "inputMethod": "string", // Required. Either "url" or "base64"
  "file": "string" // Required. URL or base64-encoded file content
}

​
Responses

​
Success (200)

Returns the URL of the converted PDF. 
{
  "url": "string" // URL to the converted PDF file
}
  • X-RateLimit-Limit: The rate limit for the user.
  • X-RateLimit-Remaining: The remaining number of requests for the user.

​
Bad Request (400)

Returned if the request is invalid or the file format is unsupported. 
{
  "error": "Error message describing the issue"
}

​
Internal Server Error (500)

Returned if there’s an error during the conversion process. 
{
  "error": "Failed to convert to PDF: [error details]"
}

​
Example Request

curl -X POST https://app.dumplingai.com/api/v1/convert-to-pdf \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
  "inputMethod": "url",
  "file": "https://example.com/document.docx"
}'

​
Notes

  • Credit usage: 50 credits per 100MB of output PDF size
  • The converted PDF is temporarily stored (24-hour retention)
  • You can get a list of supported formats by calling:
GET /api/v1/convert-to-pdf

​
Supported Formats

“.123”, “.602”, “.abw”, “.bib”, “.bmp”, “.cdr”, “.cgm”, “.cmx”, “.csv”, “.cwk”, “.dbf”, “.dif”, “.doc”, “.docm”, “.docx”, “.dot”, “.dotm”, “.dotx”, “.dxf”, “.emf”, “.eps”, “.epub”, “.fodg”, “.fodp”, “.fods”, “.fodt”, “.fopd”, “.gif”, “.htm”, “.html”, “.hwp”, “.jpeg”, “.jpg”, “.key”, “.ltx”, “.lwp”, “.mcw”, “.met”, “.mml”, “.mw”, “.numbers”, “.odd”, “.odg”, “.odm”, “.odp”, “.ods”, “.odt”, “.otg”, “.oth”, “.otp”, “.ots”, “.ott”, “.pages”, “.pbm”, “.pcd”, “.pct”, “.pcx”, “.pdb”, “.pgm”, “.png”, “.pot”, “.potm”, “.potx”, “.ppm”, “.pps”, “.ppt”, “.pptm”, “.pptx”, “.psd”, “.psw”, “.pub”, “.pwp”, “.pxl”, “.ras”, “.rtf”, “.sda”, “.sdc”, “.sdd”, “.sdp”, “.sdw”, “.sgl”, “.slk”, “.smf”, “.stc”, “.std”, “.sti”, “.stw”, “.svg”, “.svm”, “.swf”, “.sxc”, “.sxd”, “.sxg”, “.sxi”, “.sxm”, “.sxw”, “.tga”, “.tif”, “.tiff”, “.txt”, “.uof”, “.uop”, “.uos”, “.uot”, “.vdx”, “.vor”, “.vsd”, “.vsdm”, “.vsdx”, “.webp”, “.wb2”, “.wk1”, “.wks”, “.wmf”, “.wpd”, “.wpg”, “.wps”, “.xbm”, “.xhtml”, “.xls”, “.xlsb”, “.xlsm”, “.xlsx”, “.xlt”, “.xltm”, “.xltx”, “.xlw”, “.xml”, “.xpm”, “.zabw”,

​
Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
inputMethod
enum<string>
required

Indicates whether binary content is supplied via URL or base64-encoded string.

Available options:
url,
base64
​
file
string
required

Document URL or base64-encoded content to convert to PDF.

Response

PDF conversion job accepted.

​
url
string<uri>
required

Temporary download URL for the converted PDF.