TL;DR: Call
GET /v1/document/downloadwith thedocumentIdof a signed document, and we return the PDF in the response body. AddonBehalfOfwhen you sent the document for another sender. The BoldSign eSignature API page covers the rest of the API.
Your app sends a contract out for signature. Hours later, the last signer finishes, and your app needs the signed copy to store or show to the customer.
This guide shows how to download an eSigned document from your own code. It covers when to make the call, which inputs to send and what to do with the file.
How do you download an eSigned document via the API?
Send one request to GET /v1/document/download with the document’s ID. We reply with the document as a PDF.
Think of it like a coat check ticket. The documentId is your ticket number, and the download call hands back the item it belongs to. The download document API reference lists every detail of the request and response.
Which inputs does the download request take?
The request needs one value and takes two optional ones. All three go in the query string:
documentId(required): the unique ID of the documentonBehalfOf(optional): the sender email the document went out forformat(optional):CombinedorIndividually, for documents made of several uploaded files
The format setting applies only to documents created with the user preference download option. It defaults to Combined, one PDF for all files.
When do you use onBehalfOf?
Use onBehalfOf when you sent the document on behalf of another sender identity. Pass that same sender email, and you can download the file from your own account.
Our guide on sending documents on behalf of others with the API covers the sending side.
When should you call the download endpoint?
Call it after every signer has finished. Signing happens on the signers’ own time, so your code should wait for a signal instead of guessing.
That signal is the Completed webhook event. Set up webhooks and make the download call from the handler for that event. Check each request with the verify webhook events guide so you only act on real events.
Our post on how to download documents automatically with webhook callbacks shows a full handler.
What does the download code look like?
The samples below call the endpoint from the command line and with each of our software development kits (SDKs). The second argument is onBehalfOf, so drop it for documents you sent yourself.
Swap senderidentityemail@example.com for the real sender identity email when you need it.
# onBehalfOf (optional): provide the sender identity email only if the document was created on behalf of another sender identity
curl -X GET \
'https://api.boldsign.com/v1/document/download?documentId={YOUR_DOCUMENT_ID}&onBehalfOf=senderidentityemail@example.com' \
-H 'accept: application/json' \
-H 'X-API-KEY: {YOUR_API_KEY}'
var apiClient = new ApiClient("https://api.boldsign.com", "YOUR_API_KEY");
var documentClient = new DocumentClient(apiClient);
// onBehalfOf: senderidentityemail@example.com (optional; use only if the document was created on behalf of another sender identity)
var documentStream = documentClient.DownloadDocument("YOUR_DOCUMENT_ID", "senderidentityemail@example.com");
import boldsign
configuration = boldsign.Configuration(api_key="YOUR_API_KEY")
with boldsign.ApiClient(configuration) as api_client:
document_api = boldsign.DocumentApi(api_client)
# on_behalf_of (optional): provide the sender identity email only if the document was created on behalf of another sender identity
document_stream = document_api.download_document(
document_id="YOUR_DOCUMENT_ID", on_behalf_of="senderidentityemail@example.com"
)
<?php
require_once "vendor/autoload.php";
use BoldSign\Configuration;
use BoldSign\Api\DocumentApi;
$config = new Configuration();
$config->setApiKey('YOUR_API_KEY');
$document_api = new DocumentApi($config);
// on_behalf_of (optional): provide the sender identity email only if the document was created on behalf of another sender identity
$document_stream = $document_api->downloadDocument($document_id = 'YOUR_DOCUMENT_ID', $on_behalf_of = 'senderidentityemail@example.com');
ApiClient client = Configuration.getDefaultApiClient();
client.setApiKey("YOUR_API_KEY");
DocumentApi documentApi = new DocumentApi(client);
// onBehalfOf: senderidentityemail@example.com (optional; use only if the document was created on behalf of another sender identity)
File documentStream = documentApi.downloadDocument("YOUR_DOCUMENT_ID", "senderidentityemail@example.com");
import { DocumentApi } from "boldsign";
async function main() {
const documentApi = new DocumentApi();
documentApi.setApiKey("YOUR_API_KEY");
// onBehalfOf: senderidentityemail@example.com (optional; use only if the document was created on behalf of another sender identity)
const documentStream = await documentApi.downloadDocument(
"YOUR_DOCUMENT_ID",
"senderidentityemail@example.com",
);
}
main();
You can also try the call without writing code. The BoldSign public workspace on Postman has a ready document download request.
What do you do with the downloaded file?
Each call returns the PDF as a stream. Write it to a file, send it to your storage service or show it to your user.
Most teams keep the signed PDF next to its audit trail. Our guide on how to download an audit trail PDF with the API uses the same pattern.
Can you download signed documents without the API?
Yes. In the web app, open My Documents, find the completed document and select Download document from its menu.
You can also open the document and select Document download at the top of the page. Our help article on how to download signed documents shows each step.
Which BoldSign plan do you need for the download API?
Every BoldSign plan, including the free one, includes sandbox API access for testing. Live API calls and webhooks need the Enterprise API plan, from $30 a month with 40 envelopes, billed yearly.
Each extra envelope on that plan costs $0.75. Prices are in USD, as of November 2026, and the pricing page lists every plan.
How do you start downloading signed documents with BoldSign?
Try the endpoint in the sandbox first, then move it to production. Here are three next steps:
- Create a free API sandbox account and download your first signed PDF.
- Read the API getting started guide to set up your key.
- Book a demo or open a support ticket for help with your workflow.
Frequently asked questions
How do I download a signed document with the BoldSign API?
Send a request to the /v1/document/download endpoint with the documentId as a query parameter. We return the document as a PDF in the response body.
When should I download a signed document?
Download it after every signer has finished. Listen for the Completed webhook event, then make the download call from your event handler.
What does the onBehalfOf parameter do?
It names the sender email that a document went out for. Add it when you sent the document on behalf of another sender identity, and leave it out otherwise.
Can I download several uploaded files as separate PDFs?
Yes, for some documents. The optional format parameter takes Combined or Individually, and it applies only to documents created with the user preference download option.
What file type does the download API return?
You get a PDF file as a stream. Write it to a file, send it to your storage service or show it to your user.
Which programming languages can call the download endpoint?
We publish software development kits for C#, Python, Java, Node.js and more. You can also call the endpoint from the command line or a tool such as Postman.
Can I download signed documents without writing code?
Yes. In the web app, open My Documents, find the completed document and select Download document from its menu.
Can I test the download API for free?
Yes. A free API sandbox account lets you send test documents, sign them and download the results before you go live.