Every envelope and recipient in the Doctavian Signatures API moves through a defined set of statuses. This page is the complete reference for all states, what triggers each transition, and what is recorded in the audit trail.
| Status | Description |
|---|---|
Draft | The envelope has been created but not yet sent. It can be edited freely. |
Delivery Failed | Sending the envelope to a recipient failed — for example, an invalid or undeliverable email address. |
In Progress | The envelope was sent and received, but is not yet completed — at least one mandatory recipient action is still outstanding. |
Completed | All mandatory recipients have completed their assigned actions. The signed document and audit trail are available. |
Declined | A mandatory recipient declined to sign. All other recipients are notified. No further signing is possible. |
Canceled | The sender canceled the envelope. All recipients are notified. |
Expired | The envelope passed its expiry date without being completed. |
Deleted | The envelope is moved to Trash. |
Failed | Something went wrong after the envelope was sent, outside of normal recipient actions (declining or expiring). |
| Transition | Triggered by |
|---|---|
Draft → In Progress | GET /signatures/envelope/{envelopeId}/send — envelope is sent to the recipients. |
Draft → Delivery Failed | The envelope could not be delivered to a recipient (e.g. invalid email address). |
In Progress → Completed | All mandatory recipients complete their actions. |
In Progress → Declined | A mandatory recipient declines the envelope. |
In Progress → Canceled | GET /signatures/envelope/{envelopeId}/cancel — only sender can cancel the envelope. |
In Progress → Expired | The envelope's expireInDays period elapses without completion. |
In Progress → Failed | There was an unexpected error with the envelope. |
Draft → Deleted | DELETE /signatures/envelope/{envelopeId}/delete — moves the envelope into Trash. |
Deleted → Draft | GET /signatures/envelope/{envelopeId}/restore — restores a deleted envelope. |
| Status | Description |
|---|---|
In Progress | The envelope is sent to the recipient. |
Delivery Failed | Sending the envelope to a recipient failed — for example, an invalid or undeliverable email address. |
Completed | The recipient has completed all their assigned actions |
Declined | The recipient declined to sign |
Canceled | The sender canceled the envelope. All recipients are notified. |
Every meaningful action on an envelope is logged as a discrete event in its audit trail:
| Event | Logged when |
|---|---|
| Envelope created | The envelope is created. |
| Envelope sent | The envelope is sent to recipients. |
| Envelope received confirmation | Delivery of the envelope to a recipient is confirmed. |
| Envelope expired | The envelope passes its expiry date without being completed. |
| Token expired | A recipient's signing session token expired. |
| Envelope viewed | A recipient views the envelope. |
| Envelope signed | A recipient signs the envelope. |
| Envelope declined | A recipient declines to sign. |
| Envelope sign group completed | A recipient group's signing requirement is satisfied. |
| Accepted legal terms | A recipient accepts the legal terms disclosure. |
| Envelope delivery failed | Delivery of the envelope to a recipient fails. |
| Envelope expiration changed | The envelope's expiration date is updated. |
| Envelope canceled | The sender cancels the envelope. |
| 2FA authenticated | A recipient completes MFA verification. |
| Email opened | A recipient opens the initial notification email. |
| Envelope reassigned | A recipient's signing responsibility is transferred to someone else. |
| Comment created | A recipient adds a comment to a document. |