The envelope object now exposes a snapshot_url property. It returns a URL to a PDF of the envelope in its current state, with all documents and any signatures already collected. You no longer need to wait for completion to see how the final deliverable is shaping up.
What it returns
snapshot_url is populated when an envelope meets three conditions: it uses sequential routing, it is still in progress (not yet completed), and it was created within the last year. In every other case the property returns null.
By default the URL is short-lived and pre-signed, so no further authentication is needed to download it. The link expires after one hour, and retrieving the envelope again generates a fresh one. Accounts that have opted into authenticated URLs (for example, to meet HIPAA requirements) access the snapshot with their API key instead, and those URLs do not expire.
When to use it
Snapshots are useful for monitoring long-running workflows, surfacing progress in dashboards, and debugging envelopes that are stuck on a specific recipient. They give your team a complete view of what has been signed so far without disrupting the signing process or pulling the envelope out of flight.
See the envelope object docs for the full property definition.
