---
title: "Extend Document Expiry Using BoldSign API"
description: "Extend document expiry using the BoldSign API. Learn expiry types, rules, and best practices to keep signing workflows running smoothly."
url: "https://boldsign.com/blogs/extend-document-expiry-boldsign-api/"
---

1. [Blog](https://boldsign.com/blogs.md)
2. [API](https://boldsign.com/category/api.md)

# Keep Signing Processes Active by Extending Document Expiry with BoldSign API

[Ranjitha Vazhivittan](https://boldsign.com/author/ranjitha-vazhivittan/) December 5, 2025 Updated March 2, 2026 4 min read

If you are running your eSignature flows through APIs, you have probably hit this annoying edge case: everything in your automation works perfectly until a signer takes a bit longer than expected. The document quietly expires even though the deal is still very much alive.

This is exactly where [extending document expiry via API](https://developers.boldsign.com/documents/extend-document-expiry?region=us) becomes a lifesaver. Instead of treating expiry as a fixed setting, your services can adjust it on the fly based on what is actually happening in your systems—an opportunity still in pipeline, an approval waiting on a manager, or a contract stuck in legal review.

In this blog, we will walk through how a simple BoldSign API call to extend expiry can keep your signing processes running smoothly, without brittle hacks, noisy retries, or frustrated stakeholders.

## Why extend a document expiry?

- **Prevent unintended expiry:** Give signers more time if they are unavailable or miss the deadline.
- **Support ongoing negotiations:** Keep documents active while discussions continue.
- **Avoid resending documents:** Update the expiry without recreating templates or configuring fields again.
- **Ensure compliance:** Regulated workflows often require extended review time.

## Expiry types in BoldSign

BoldSign supports three expiry configurations:

- **Days:** yyyy-MM-dd (e.g., 2025-10-15)
- **Hours:** Integer (e.g., 12)
- **Specific date and time:** ISO format (e.g., 2025-10-15T10:58:04Z)

If you want to set the expiration date when sending the signature request, check out [How to apply expiration date for eSignature requests through API](https://boldsign.com/blogs/how-to-apply-expiration-date-for-esignature-requests-through-api.md).

## How to extend the expiry with the BoldSign API

To extend expiry:

- The document must be unsigned.
- New expiry must be greater than or later than the current expiry.
- Expiry cannot exceed 180 days from document creation.

You will first retrieve the current expiry configuration and then update it with a new value through the API.

> Refer to the [documentation](https://developers.boldsign.com/sdks/overview/?region=us) to install the SDKs for your application’s technology stack. After installation, generate your API key in BoldSign. Use the API key generation [guide](https://developers.boldsign.com/authentication/api-key/?region=us) for detailed steps.

## Step 1: Get document properties

- Before [extending a document’s expiry date](https://developers.boldsign.com/how-to-guides/extend-the-expiry-date-of-the-document/), you must first check its current `expiryDateType` and `expiryValue`. Retrieve the document properties by using the BoldSign API.
- Use the following endpoint: `GET /v1/document/properties`
- You can refer to the official documentation here: [Get Document Properties API](https://developers.boldsign.com/documents/document-details-and-status/?region=us)
- This API call returns all relevant details about the document, including any forms added—such as signature or text fields—as well as the expiry configuration (`expiryDateType` and `expiryValue`).

## Step 2: Extend the expiry date

After you find out the `expiryDateType`, you can use the code snippets below to update the document expiry date by using the API.

```
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);
```

## Important properties and rules for updating expiry dates

To ensure a successful update, follow these rules:

- **`documentId` :** The ID of the document to update.

- **`newExpiryValue` :**\
  Format depends on the original expiry type:

  - Days → yyyy-MM-dd
  - Hours → Integer value
  - Specific Date & Time → ISO format

- **`warnPrior` :**

  - true: Sends reminder 1 day before expiry
  - false: Disables reminder
  - null: Keeps existing configuration

- New expiry must be greater than or later than the current expiry.

- Expiry must not exceed 180 days from document creation.

A successful update returns 200 OK with the new expiry details.

## Key benefits of extending document expiry

- **Greater flexibility:** Adjust expiry dates to match changing project timelines or client availability without starting over.
- **Improved completion rates:** Giving recipients more time increases the chances of getting documents signed and returned.
- **Better user experience:** Signers appreciate having extra time, especially when delays are unavoidable.
- **Enhanced workflow efficiency:** Keeps your document pipeline moving smoothly without interruptions due to expired links.

## Conclusion

Delays are inevitable—but restarting your signing workflow doesn’t have to be. With BoldSign expiry extension API, you can adapt to everyday challenges and keep your documents moving forward.

**Ready to try it?**

View the API Reference in the [BoldSign API documentation](https://developers.boldsign.com/api-overview/getting-started/?region=us) and sign up for a [free sandbox account](https://account.boldsign.com/signup?planId=1076\&utm_source=boldsignblogs\&utm_medium=redirect\&utm_campaign=boldsign) to get started.

Need help? Reach out to [our support](https://support.boldsign.com/support/tickets/create) team or [schedule a personalized demo](https://boldsign.com/request-demo.md)—we’re here to help.

Topics [API integration](https://boldsign.com/blogs/tag/api-integration.md)

## Sign documents 3x faster

Send, sign and manage documents securely and efficiently.

[Try it today](https://account.boldsign.com/signup?planId=1018\&utm_source=boldsignblogs\&utm_medium=redirect\&utm_campaign=boldsign)

## 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](https://boldsign.com/author/ranjitha-vazhivittan/)

## Related posts

- [API](https://boldsign.com/category/api.md) September 29, 2026 10 min read

  ## [How to Migrate from Docusign Without Losing Templates or Workflow Continuity](https://boldsign.com/blogs/migrate-from-docusign.md)

  Learn how to migrate from Docusign while protecting templates, signed records, and active workflows. Explore key risks, a practical checklist, and next steps.

- [API](https://boldsign.com/category/api.md) September 25, 2026 10 min read

  ## [Build vs Buy an eSignature API: What Should You Choose?](https://boldsign.com/blogs/build-vs-buy-esignature-api-guide.md)

  Compare the real cost, compliance risk, launch speed, and maintenance burden of building vs buying an eSignature API before you commit.

- [API](https://boldsign.com/category/api.md) September 22, 2026 9 min read

  ## [What Are the Common Challenges When Using Signature APIs in Software Development](https://boldsign.com/blogs/common-signature-api-challenges.md)

  Explore the common challenges developers face with a Signature API, from authentication issues to PDF rendering, webhooks, templates, and rate limits.

Get started

## Sign up for your free trial today!

[Start free trial](https://account.boldsign.com/signup?planId=1018)

- 30-day free trial
- No credit card required

*Picture: A completed employment contract: signed by John Doe on 11/03/2026, all parties have signed*
