Upload logo

Upload Files

Upload files is a REST API tool that supports flexible options for uploading one or more files from local storage or from public URL prior to processing.

A bubbling flask with code brackets inside
Try Now with API Lab

Start right from your browser - upload files, choose parameters, generate code, and send API Calls directly from API Lab!  

 to receive your free API Key.
Parameters
Required Parameters
POST
/upload
curl -X POST "https://api.pdfrest.com/upload" \ 
  -H "Accept: application/json" \ 
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
Response
The response for your API Call will display here.
Once you've sent your POST request and received a valid response, you can download your output file using the output URL.
Build your solution

You have document processing problems, we have Solutions. Explore the many ways pdfRest can align your documents with your business objectives.

Browse all Solutions

Why does pdfRest API offer the most convenient file uploads?

pdfRest offers the best solution for uploading files for processing, because it supports multiple files at once, upload from URL, and intuitive responses for easy resource tracking.

Multiple Files at Once

Easily upload many files with one API Call.  There is no limit to the number of files you may upload at once.  Choose between uploading files from local storage or files from public URLs.  Receive a response with convenient reference IDs associated with each file to use for subsequent processing steps. Note that a file size limit applies to the total of all files included in the call - see your plan details on the Pricing page for more information about upload file size limits.

Upload from URL

If your files are hosted somewhere accessible by public URL, you can easily pass those URLs into the Upload Files API Tool without the need to download them to your own local storage first.  pdfRest will directly download files from specified URLs to the processing server, saving you time and avoiding unnecessary storage requirements. You can even pass multiple URLs with the same call to upload many files from URL at once!

Keep Track of Uploads

Streamline your workflow by pre-uploading files before processing.  The Upload Files API Tool makes it easy to upload files in advance and store information about each uploaded file. This tool returns a JSON response intuitively arranged to help you associate your uploaded file names with their generated resource IDs.  These resource IDs can be used to initiate subsequent processing steps for uploaded files.

Start from Code Examples
  1. First, you'll need an API Key - to:
    • Stay anonymous with a Guest API Key for 10 free API Calls
    • Sign up for an upgraded API Key with unlimited, continuous service
  2. Choose your programming language
  3. Copy and paste the code to your project
  4. Update Api-Key field with your unique API Key
  5. Update file with the local path to your input
  6. Run this code to send an API Call
See more code examples in our
GitHub repository
Try pdfRest with just a few clicks
Download our Postman Postman Collection
Read More 
curl -X POST "https://api.pdfrest.com/upload" \
  -H "Accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -H "Api-Key: xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" \
  -F "file=@../Sample_Input/ducky.pdf" \
  -F "file=@../Sample_Input/merge1.pdf" \
  -F "file=@../Sample_Input/strawberries.jpg" \

Need more help?

Start with a Tutorial for step-by-step guidance

1
1 of 1 pages (1 items)
Customize Your Solution
file
Local file to be uploaded.

This parameter may be included multiple times to upload multiple files but may not be combined with url parameter.
See Documentation
Generate a self-service API Key now!

Create your FREE API Key to start processing PDFs in seconds, only possible with pdfRest.

Compare Plans
Contact Us