Recipient status codes | Docusign

As the Docusign platform automatically routes an envelope from one recipient to the next, the recipient’s status changes to reflect this progress.

Note: Recipient status is distinct from envelope status. A recipient status indicates their progress towards performing their required actions, while an envelope status shows the envelope’s progress as a whole. Typically, envelope status is updated after each recipient has reached a new stage in the signing process.

The following diagram shows the major steps of the signing process for each recipient:

Retrieving recipient status

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

To retrieve the status of all envelope recipients, you can also make a request to the EnvelopeRecipients:list endpoint or a corresponding SDK method.

Recipient status code descriptions

The table below provides descriptions of the recipient status codes.

Recipient status	Description
`autoresponded`	The recipient’s email system auto-responded to the email from Docusign. This status is used in the Docusign web app (also known as the Docusign console) to inform senders about the auto-responded email.
`completed`	The recipient has completed their actions (signing or other required actions if not a signer) for an envelope.
`created`	The recipient’s envelope is in a draft state (the envelope status is `created`).
`declined`	The recipient declined to sign the document(s) in the envelope.
`delivered`	The recipient has 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.
`faxpending`	The recipient has finished signing, and the system is awaiting a fax attachment by the recipient before completing their signing step.
`sent`	The recipient has been sent an email notification that it is their turn to sign an envelope.
`signed`	The recipient has completed (performed all required interactions, such as signing or entering data) all required tags in an envelope. This is a temporary state during processing, after which the recipient status is automatically updated to `completed`.

Next steps

For more information about retrieving recipient status, see:

For information about errors, see:

Error codes for information about interpreting and handling errors.
Troubleshooting for common errors for detailed information about causes and resolutions for specific errors.