Keep Signing Processes Active by Extending Document Expiry with BoldSign API

Source: Dev.to

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

How to extend the expiry with the BoldSign API

Step 1: Get document properties

Before extending a document’s expiry date, you must first check its current expiryDateType and expiryValue. Retrieve the document properties using the BoldSign API:

GET /v1/document/properties

Refer to the official documentation: Get Document Properties API

The response includes all relevant details about the document, including any forms added and the expiry configuration (expiryDateType and expiryValue).

Step 2: Extend the expiry date

After you know the expiryDateType, use the following request to update the document expiry:

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}'

Important properties and rules for updating expiry dates

• 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 – Controls reminder behavior:
  • true – Sends a reminder 1 day before expiry
  • false – Disables reminder
  • null – Keeps existing configuration

Additional rules:

• 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’s 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 and sign up for a free sandbox account to get started.

This blog was originally published at boldsign.com.