REST API Recipe: Get Envelope Status
This recipe retrieves an envelope’s current status. The Envelope::get method returns all current information about the envelope including its status (Created, Deleted, Sent, Delivered, Signed, Completed, Declined, etc), the time and date of the most recent action on the envelope, and other information.
You’ll need a DocuSign account email and password that has access to the envelope’s status information. You’ll also need an integration key. See Generate Your Integrator Key. And you’ll need an envelope ID. You can send an envelope via the API to get an envelope ID. Or you can send an envelope via the web UI and then request the envelope’s summary or certificate information from the web UI. The summary document includes the envelope ID.
How to do it
Step 1: use the login_information API end point to obtain the base url for use in subsequent API calls, and the user’s account ID. See the recipe Request a Signature via Email for an example of this step.
Step 2: Send the Envelopes::get request and use the response status object.
How it works
A key part of this recipe is to use the right username/password. Depending on your Use Case, you can use the sender’s information, or a “System Account” that has access to all envelope information within the account. You can also use an SSO token as a proxy for the sender’s credentials.
DocuSign tracks the status of each envelope and of each recipient within envelopes. This recipe covers the envelope’s status. Use method Recipients::envelopeList to retrieve the recipients’ statuses.