For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dropbox Sign WebSDKsSign Up
DocumentationAPIChangelog
DocumentationAPIChangelog
  • API Quickstart
  • API Reference
    • Welcome
    • Authentication
    • Account
    • Signature Request
      • GETGet Signature Request
      • GETList Signature Requests
      • GETDownload Files
      • GETDownload Files as Data Uri
      • GETDownload Files as File Url
      • POSTSend Signature Request
      • POSTSend with Template
      • POSTBulk Send with Template
      • POSTSend Request Reminder
      • POSTRelease On-Hold Signature Request
      • POSTUpdate Signature Request
      • POSTCancel Incomplete Signature Request
      • POSTRemove Signature Request Access
      • POSTEmbedded Bulk Send with Template
      • POSTCreate Embedded Signature Request
      • POSTCreate Embedded Signature Request with Template
      • PUTEdit Signature Request
      • PUTEdit Embedded Signature Request
      • PUTEdit Embedded Signature Request with Template
      • PUTEdit Signature Request With Template
    • Template
    • Bulk Send Job
    • Report
    • Team
    • Unclaimed Draft
    • Embedded
    • API App
    • Fax
    • Fax Line
  • Manual Reference Pages
    • Warnings and Errors
    • Constants
    • Search
    • Premium Branding
    • Expiration
LogoLogo
Dropbox Sign WebSDKsSign Up
On this page
  • Signature Request Endpoints
API Reference

Signature Request

||View as Markdown|
Was this page helpful?
Previous

Verify Account

Next

Get Signature Request

Built with

Signature Request endpoints are how the Dropbox Sign API facilitates signing. They’re used to send and interact with new signature requests, as well as manage, and gain insight into requests that have already been sent. Signature Requests offer a broad range of features, such as: group signing, Advanced and Qualified Electronic Signatures, identity verification, SMS delivery, and much more.

The Signature Request object returned by these endpoints can be used to reference request-specific data including the names and email addresses of signers, custom fields, metadata, response data, and timestamps for when the request was created and completed.

Tips:

  • The /signature_request/list endpoint returns a list of Signature Request objects that your account can access. Using query string parameters to apply search logic is a great way to find specific documents or requests.
  • Need to update a signer name or email for an in-flight Signature Request? Pass the updated information and signature_request_id to /signature_request/update/{signature_request_id}.

When Signature Requests are sent without any signer fields on the document, Dropbox Sign automatically appends a signature page on the end of the file. Placing signer fields on the document prevents this behavior. Learn more about placing fields on documents in this Help Center article: How to Place Fields Directly on Documents.

Warning

Signature Requests that use an appended signature page cannot be updated. The /signature_request/update endpoint only works on documents that contain signer fields.

Signature Request Endpoints

SummaryEndpointDescription
Get Signature Request/signature_request/{signature_request_id}Returns the Signature Request specified by the signature_request_id parameter.
List Signature Requests/signature_request/listReturns a list of SignatureRequests that you can access.
Download Files^^/files/{signature_request_id}Obtain a copy of the current documents specified by the signature_request_id parameter.
Download Files as Data Uri^^/files_as_data_uri/{signature_request_id}Returns a JSON object with a data_uri representing the base64 encoded file (PDFs only).
Download Files as File Url^^/files_as_file_url/{signature_request_id}Returns a JSON object with a url to the file (PDFs only).
Send Signature Request/signature_request/sendCreates and sends a new SignatureRequest with the submitted documents.
Send with Template/signature_request/send_with_templateCreates and sends a new SignatureRequest based off of the Template(s) specified with the template_ids parameter.
Bulk Send with Template/signature_request/bulk_send_with_templateCreates BulkSendJob which sends up to 250 SignatureRequests in bulk based off of the provided Template(s) specified with the template_ids parameter.
Send Request Reminder^^/remind/{signature_request_id}Sends an email to the signer reminding them to sign the signature request.
Release On-Hold Signature Request^^/release_hold/{signature_request_id}Releases a held SignatureRequest that was claimed and prepared from an UnclaimedDraft.
Update Signature Request^^/update/{signature_request_id}Updates the email address and/or the name for a given signer on a signature request.
Cancel Incomplete Signature Request^^/cancel/{signature_request_id}Cancels an incomplete signature request. This action is not reversible.
Remove Signature Request Access^^/remove/{signature_request_id}Removes your access to a completed signature request. This action is not reversible.
Create Embedded Signature Request/signature_request/create_embeddedCreates a new SignatureRequest with the submitted documents to be signed in an embedded iFrame.
Create Embedded Signature Request with Template^^/create_embedded_with_templateCreates a new SignatureRequest based on the given Template(s) to be signed in an embedded iFrame.
Embedded Bulk Send with Template^^/bulk_create_embedded_with_templateCreates BulkSendJob which sends up to 250 SignatureRequests in bulk based off of the provided Template(s) specified with the template_ids parameter to be signed in an embedded iFrame.