Skip to content
  1. Blog
  2. API

How to Extend Document Expiry with the BoldSign API

TL;DR: You can extend a document’s expiry with one request: PATCH /v1/document/extendExpiry. Read the document’s expiry type first, then send a later value in the same format. The document must be unsigned, and the new date cannot pass 180 days from creation. The extend document expiry reference lists every field.

Your signing flow runs through the API, and it works well until a signer takes longer than planned. A manager is on leave, or a contract sits in legal review. The deal is still alive, but the document expires anyway.

Sending the document again means rebuilding fields and asking the signer to start over. A short API call can push the deadline back instead. This guide shows how to check the current expiry, extend it, and stay inside the rules.

Why extend a document’s expiry instead of resending it?

Extending keeps the same document, fields and signers in place. Your signer simply gets more time to finish.

Teams extend expiry for reasons like these:

  • A signer is away or missed the deadline.
  • A negotiation is still going on.
  • An approval is waiting on someone else.
  • A regulated review needs more days than first planned.

See how to apply an expiration date to eSignature requests through the API to set the first deadline when you send a request.

What are the expiry types in BoldSign?

Every document has one of three expiry types. The type decides the format of the new value you send.

Expiry type Format of the new value Example
Days A date, yyyy-MM-dd 2026-12-15
Hours A whole number 12
Specific date and time A full date and time 2026-12-15T10:58:04Z

Think of it like a library loan. You renew the same book with a new due date, and the date has to match the library’s own format.

What rules apply when you extend expiry with the BoldSign API?

Three rules decide whether the request succeeds. Check them before you call the endpoint.

  • The document must be unsigned.
  • The new expiry must be later than the current one.
  • The new expiry cannot pass 180 days from the document’s creation date.

Only the sender and the account admin can extend a document. Add the sender’s email address in onBehalfOf when you sent the document on someone’s behalf.

How do you extend the expiry with the BoldSign API?

First read the document’s current expiry, then send the new value. Install the BoldSign software development kit (SDK) for your language and create a key with the API key guide.

Step 1: Get the document properties

Call GET /v1/document/properties with the document ID. The response holds the document’s status, signers and fields, plus expiryDateType and expiryValue.

The document details and status reference shows the full response. The extend expiry guide walks through both calls.

Step 2: Extend the expiry date

Send the new value in the format that matches expiryDateType. The samples below make the same call in six languages.

curl -X PATCH \
  "https://api.boldsign.com/v1/document/extendExpiry?documentId={documentId}" \
  -H 'X-API-KEY: {your API key}' \
  -H "Content-Type: application/json" \
  -d "{\"newExpiryValue\": \"2025-12-15\", \"warnPrior\": true}"
var apiClient = new ApiClient("YOUR_API_KEY");

var documentClient = new DocumentClient(apiClient);
documentClient.ExtendExpiry("YOUR_DOCUMENT_ID", "YOUR_EXPIRY_DATE");
import boldsign
configuration = boldsign.Configuration(api_key="YOUR_API_KEY")
with boldsign.ApiClient(configuration) as api_client:
    document_api = boldsign.DocumentApi(api_client)
    extend_expiry = boldsign.ExtendExpiry(newExpiryValue="YOUR_EXPIRY_DATE")
    document_api.extend_expiry(document_id="YOUR_DOCUMENT_ID", extend_expiry=extend_expiry)
<?php require_once "vendor/autoload.php";

use BoldSign\Configuration;
use BoldSign\Api\DocumentApi;
use BoldSign\Model\ExtendExpiry;

$config = new Configuration();
$config->setApiKey('YOUR_API_KEY');

$document_api = new DocumentApi($config);

$extend_expiry = new ExtendExpiry();
$extend_expiry->setNewExpiryValue('YOUR_EXPIRY_DATE');

$document_api->extendExpiry($document_id = 'YOUR_DOCUMENT_ID', $extend_expiry);
ApiClient client = Configuration.getDefaultApiClient();
client.setApiKey("YOUR_API_KEY");

DocumentApi documentApi = new DocumentApi(client);

ExtendExpiry extendExpiry = new ExtendExpiry();
extendExpiry.setNewExpiryValue("YOUR_EXPIRY_DATE");

documentApi.extendExpiry("YOUR_DOCUMENT_ID", extendExpiry);
import { DocumentApi, ExtendExpiry } from "boldsign";

const documentApi = new DocumentApi();
documentApi.setApiKey("YOUR_API_KEY");

const extendExpiry = new ExtendExpiry();
extendExpiry.newExpiryValue = "YOUR_EXPIRY_DATE";

documentApi.extendExpiry("YOUR_DOCUMENT_ID", extendExpiry);

Which fields does the extend expiry request take?

The request takes the document ID in the query string and a short request body. A successful call returns status 200.

  • documentId (required): the ID of the document to extend.
  • newExpiryValue (required): the new expiry, in the format set by the expiry type.
  • onBehalfOf: the sender’s email address, for a document sent on behalf of someone.
  • warnPrior: whether we email the signer one day before the new expiry.

How does warnPrior behave?

Set warnPrior to match how you want the signer reminded:

  • true: we email the signer one day before the expiry date.
  • false: we skip that email.
  • null: the document keeps its current setting.

What should you watch out for?

A call that breaks one of the rules above will not go through. Read the properties first, and your code can check each rule before it sends.

  • Send the date in the document’s own format. An Hours document expects a whole number, not a date.
  • Store the creation date, so your code can stop before the 180-day limit.
  • Skip documents that are already signed.

Which BoldSign plan do you need for the API, and what does it cost?

Live API access comes with the Enterprise API plan, which starts at $30 a month with 40 envelopes. Extra envelopes cost $0.75 each.

You can build and test first in our free sandbox, with no credit card. Sandbox documents carry a test watermark and are deleted after 14 days. Prices are in USD, as listed on the BoldSign pricing page in November 2026.

Where do you go next with document expiry via API?

Try the call on a test document in the sandbox first. Then add the checks your workflow needs.

Frequently asked questions

Can I extend the expiry date of a document after sending it?

Yes. Send a request to the /v1/document/extendExpiry endpoint with the document ID and a later expiry value. The document must still be unsigned.

Can I shorten a document's expiry date with the API?

No. The extend expiry endpoint only moves the date later. To close a request early, revoke the document instead.

What is the longest I can extend a document's expiry?

The new expiry cannot go past 180 days from the day the document was created. Plan longer deals around that limit.

Which format does newExpiryValue use?

It follows the document's expiry type. Days takes a date such as 2026-12-15, Hours takes a whole number such as 12, and a specific date and time takes a full timestamp.

How do I find a document's current expiry type?

Call the /v1/document/properties endpoint with the document ID. The response holds expiryDateType and expiryValue.

Who can extend a document's expiry in BoldSign?

The sender and the account admin can extend it. Pass the sender's email address in onBehalfOf when you sent the document on someone's behalf.

Does the signer get told about the new expiry date?

Set warnPrior to true and we email the signer one day before the new expiry date. Set it to false to skip that email, or leave it null to keep the current setting.

Can I test the extend expiry endpoint for free?

Yes. Our free API sandbox needs no credit card. Sandbox documents carry a test watermark and are deleted after 14 days.

Ranjitha Vazhivittan

Ranjitha is a skilled software developer with 3 years of experience at BoldSign. Alongside her technical expertise, she has a passion for writing and enjoys sharing thoughtful insights on technology and development. Beyond work, she stays curious by exploring emerging tools and trends, constantly seeking opportunities to learn and grow.

More posts by Ranjitha Vazhivittan
Get started

Sign up for your free trial today!

Start free trial
  • 30-day free trial
  • No credit card required