Download Processed File
Download a previously processed PDF or rendered image from storage
/v1/pdf/download/{object_name}
curl "https://pdf.toolkitapi.io/v1/pdf/download/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.pdf" \
-H "Authorization: Bearer YOUR_API_KEY" \
--output result.pdf
import httpx
resp = httpx.get(
"https://pdf.toolkitapi.io/v1/pdf/download/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.pdf",
)
print(resp.json())const resp = await fetch("https://pdf.toolkitapi.io/v1/pdf/download/a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.pdf", {
});
const data = await resp.json();
console.log(data);# See curl example(Binary PDF or image content streamed directly as the response body)Try It Live
Description
How to Use
1. Call a PDF processing endpoint that returns an `object_name` or `upload_url` in its response.
2. Extract the object name — it follows the pattern `{32-hex-chars}.{extension}` (e.g. `a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6.pdf`).
3. Send a GET request to `/v1/pdf/download/{object_name}` with your API key.
4. The response body is the raw file content with the appropriate `Content-Type` header. Save it to disk or stream it to a client.
About This Tool
The Download endpoint lets you retrieve processed files that were stored during a previous PDF operation. When a processing endpoint produces an output file and stores it internally, it returns an `object_name` — a UUID-based filename with an extension (e.g. `.pdf`, `.png`, `.jpeg`). Use this endpoint to fetch that file.
This is a companion endpoint to the processing tools. Rather than receiving large base64-encoded files inline in JSON responses, some workflows store the result and give you a download link instead. This keeps response payloads small and lets you stream the file directly.
The endpoint validates the object name format and streams the file with the correct MIME type, making it suitable for direct browser downloads or piping to disk.
Why Use This Tool
- Deferred retrieval — Process a PDF now, download the result later
- Reduced payload size — Avoid large base64 blobs in JSON responses by fetching files separately
- Direct browser download — Link users directly to the download URL for processed files
- Pipeline integration — Chain processing steps by downloading intermediate results
Frequently Asked Questions
What file formats can I download?
How long are files available for download?
What happens if the object name is invalid?
Start using Download Processed File now
Get your free API key and make your first request in under a minute.