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.

Getting ready

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.

 

Source files

The recipe source files are available on Github: Java, C#, Objective-C, Python, PHP, and Node-JS

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.

There’s more

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.