Skip to navigation

Envelope status codes

View as Markdown

An envelope’s status code indicates where it is in its workflow. This enables you to monitor which envelopes have been completed and which ones are outstanding. In addition, your integration can initiate custom processing based on changes in envelope status.

Retrieving envelope status

As a best practice for retrieving envelope status, use Docusign Connect and a listener to subscribe to receive updates. When an envelope status changes, Docusign Connect will send your listener a message letting you know and enabling your integration to respond immediately.

You can also retrieve envelope status by making a request to one of these endpoints or a corresponding SDK method:

Envelope status code descriptions

The table below provides descriptions of the envelope status codes.

Envelope statusDescription
completedThe envelope has been completed by all the recipients.
correctThe envelope has been opened by the sender for correction. The signing process is stopped for envelopes with this status.
createdThe envelope is in a draft state and has not been sent for signing.
declinedThe envelope has been declined for signing by one of the recipients.
deletedThis is a legacy status and is no longer used.
deliveredAll recipients have viewed the document(s) in an envelope through the Docusign signing website. This does not indicate an email delivery of the documents in an envelope.
sentAn email notification with a link to the envelope has been sent to at least one recipient. The envelope remains in this state until all recipients have viewed it at a minimum.
signedThe envelope has been signed by all the recipients. This is a temporary state during processing, after which the envelope is automatically moved to completed status.
templateThe envelope is a template.
timedoutThis is a legacy status and is no longer used.
voidedThe envelope has been voided by the sender or has expired. The void reason indicates whether the envelope was manually voided or expired.

Next steps

For more information about retrieving envelope status, see:

For information about errors, see: