> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# Envelope status codes

> Learn about envelope statuses for the eSignature REST API.

An envelope’s [status code](/docs/esign-rest-api/esign101/concepts/envelopes/status-codes#envelope-status-code-descriptions) 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](/platform/webhooks/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:

* [Envelopes:get](/docs/esign-rest-api/reference/envelopes/envelopes/get): returns the status of a single envelope
* [Envelopes:listStatusChanges](/docs/esign-rest-api/reference/envelopes/envelopes/liststatuschanges): returns statuses for all envelopes that match filters you specify

## Envelope status code descriptions

The table below provides descriptions of the envelope status codes.

| Envelope status | Description                                                                                                                                                                     |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `completed`     | The envelope has been completed by all the recipients.                                                                                                                          |
| `correct`       | The envelope has been opened by the sender for correction. The signing process is stopped for envelopes with this status.                                                       |
| `created`       | The envelope is in a draft state and has not been sent for signing.                                                                                                             |
| `declined`      | The envelope has been declined for signing by one of the recipients.                                                                                                            |
| `deleted`       | This is a legacy status and is no longer used.                                                                                                                                  |
| `delivered`     | All 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.       |
| `sent`          | An 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. |
| `signed`        | The 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.         |
| `template`      | The envelope is a template.                                                                                                                                                     |
| `timedout`      | This is a legacy status and is no longer used.                                                                                                                                  |
| `voided`        | The 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:

* [Docusign Connect](/platform/webhooks/connect)
* [How to get envelope information](/docs/esign-rest-api/how-to/get-envelope-information)
* [How to list envelope status changes](/docs/esign-rest-api/how-to/list-envelope-status-changes)

For information about errors, see:

* [Error codes](/docs/esign-rest-api/esign101/error-codes) for information about interpreting and handling errors.
* [Troubleshooting for common errors](/docs/esign-rest-api/esign101/error-codes/troubleshooting-common-errors) for detailed information about causes and resolutions for specific errors.