Docusign - Get envelope action
The Get envelope action retrieves the details of a single envelope. Refer to the Docusign Envelopes: get API reference for the full field reference.
Input
| Input field | Description |
|---|---|
| Envelope ID | Enter the ID of the envelope to retrieve. |
Output
| Output field | Description |
|---|---|
| Envelope ID | The ID assigned to the envelope for tracking and managing the document lifecycle. |
| Status | The current status of the envelope. |
| Email subject | The subject line of the email sent to all recipients. |
| Signing location | The physical location where signing takes place. Valid values are InPerson and Online. The default value is Online. |
| Purge state | The current purge state of the envelope's documents. |
| Envelope location | Reserved for Docusign. |
| Any signer | Deprecated. This feature has been replaced by signing groups. |
| Voided reason | The reason the envelope was voided. |
| Expire enabled | Indicates whether the envelope is set to expire after a set number of days. |
| Expire after | The number of days before the envelope expires. |
| Allow markup | Indicates whether the Document Markup feature is enabled. |
| Envelope ID stamping | Indicates whether the envelope ID is stamped on the documents. |
| Auto navigation | Indicates whether auto-navigation is set for the recipient. |
| Is signature provider envelope | Indicates whether the envelope uses a third-party signature provider. |
| Is ticket related envelope | Indicates whether the envelope is associated with a support ticket. |
| Created date time | The date and time the envelope was created. |
| Sent date time | The date and time the envelope was sent. |
| Delivered date time | The date and time the envelope was delivered to recipients. |
| Completed date time | The date and time the envelope was completed. |
| Last modified date time | The date and time the envelope was last modified. |
| Status changed date time | The date and time the envelope's status last changed. |
| Envelope URI | The URI for retrieving the envelope. |
| Documents URI | The URI for retrieving the envelope's documents. |
| Recipients URI | The URI for retrieving the envelope's recipients. |
| Attachments URI | The URI for retrieving the envelope's attachments. |
| Custom fields URI | The URI for retrieving the envelope's custom fields. |
| Notification URI | The URI for retrieving the envelope's notification settings. |
| Templates URI | The URI for retrieving the envelope's templates. |
| Certificate URI | The URI for retrieving the envelope's certificate of completion. |
| Documents combined URI | The URI for retrieving all documents combined into a single PDF. |
| Sender | Information about the user who sent the envelope. |
| User ID (Sender) | The ID of the user who sent the envelope. |
| User name (Sender) | The name of the user who sent the envelope. |
| Email (Sender) | The email address of the user who sent the envelope. |
| Account ID (Sender) | The ID of the account that sent the envelope. |
| IP address (Sender) | The IP address of the user who sent the envelope. |
| Email blurb | The email message body sent to all recipients. |
| Initial sent date time | The date and time the envelope was first sent. |
| Expire date time | The date and time the envelope expires. |
| Voided date time | The date and time the envelope was voided. |
| Envelope metadata | Metadata describing the correction and notary options for the envelope. |
| Allow advanced correct (Envelope metadata) | Indicates whether advanced correction is allowed. |
| Allow correct (Envelope metadata) | Indicates whether correction is allowed. |
| Enable sign with notary (Envelope metadata) | Indicates whether signing with a notary is enabled. |
| Enable wet sign | Indicates whether the signer can print the document and sign it on paper. |
| Allow reassign | Indicates whether the recipient can redirect the envelope to a more appropriate recipient. |
| Is 21 CFR Part 11 | Indicates whether the envelope complies with 21 CFR Part 11 (FDA electronic records). |
| Signer can sign on mobile | Indicates whether signers can sign on a mobile device. |
| U sig state | Reserved for Docusign. |
| Has form data changed | Indicates whether the form data in the envelope has changed. |
| Allow view history | Indicates whether recipients can view the history of the envelope. |
| Is dynamic envelope | Indicates whether the envelope is a dynamic envelope. |
| Burn default tab data | Indicates whether default tab data is burned into the documents. |
| Recipients | Information about the envelope's recipients. |
| Current routing order (Recipients) | The routing order currently being processed. |
| Recipient count (Recipients) | The total number of recipients on the envelope. |
| Signers (Recipients) | Recipients who must sign the documents. |
| In person signers (Recipients) | Recipients who sign in person, hosted by another user. |
| Witnesses (Recipients) | Recipients who witness the signing. |
| Carbon copies (Recipients) | Recipients who receive a copy of the completed documents but do not sign. |
| Certified deliveries (Recipients) | Recipients who must receive the documents but do not sign. |
| Agents (Recipients) | Recipients who can add name and email information for other recipients. |
| Editors (Recipients) | Recipients who can edit the envelope's recipients and documents. |
| Intermediaries (Recipients) | Recipients who can add recipients after themselves in the routing order. |
| Seals (Recipients) | Electronic seal recipients applied to the documents. |
| Notaries (Recipients) | Recipients who act as a notary. |
The Recipients field groups recipients by type. Each type listed above contains the fields described in Recipient fields.
Recipient fields
Each recipient type (such as Signers and Witnesses) contains the following fields.
| Output field | Description |
|---|---|
| Recipient ID | The ID of the recipient within the envelope. |
| Recipient ID GUID | The globally unique identifier (GUID) for the recipient. |
| Recipient type | The type of recipient (for example, signer or carbon copy). |
| The recipient's email address. | |
| Name | The recipient's name. |
| Status | The recipient's current status. |
| Role name | The role assigned to the recipient. |
| Routing order | The order in which the recipient receives and acts on the envelope. |
| User ID | The ID of the Docusign user associated with the recipient. |
| Client user ID | The identifier used for an embedded (captive) recipient. |
| Delivery method | The method used to deliver the envelope to the recipient. |
| Note | A private note displayed to the recipient. |
| Sent date time | The date and time the envelope was sent to the recipient. |
| Delivered date time | The date and time the recipient viewed the envelope. |
| Signed date time | The date and time the recipient signed. |
| Completed date time | The date and time the recipient completed their action. |
| Require ID lookup | Indicates whether the recipient must be verified through ID lookup. |
| Is bulk recipient | Indicates whether the recipient is part of a bulk send. Applies to signers only. |
| Recipient supplies tabs | Indicates whether the recipient supplies their own tabs. Applies to signers only. |
| Require upload signature | Indicates whether the recipient must upload a signature. Applies to signers only. |
| Completed count | The number of times the recipient has completed signing. |
| Total tab count | The total number of tabs assigned to the recipient. |
| Creation reason | The reason the recipient was added to the envelope. |
| Tabs | The tabs assigned to the recipient, grouped by type. See Tab fields. |
Tab fields
The Tabs field groups a recipient's tabs by type. Each tab contains the following fields, regardless of its type.
Tab types include:
- Sign here tabs
- Initial here tabs
- Date signed tabs
- Full name tabs
- First name tabs
- Last name tabs
- Email address tabs
- Title tabs
- Company tabs
- Email tabs
- SSN tabs
- ZIP tabs
- Text tabs
- Number tabs
- Date tabs
- Checkbox tabs
- List tabs
- Radio group tabs
- Note tabs
| Output field | Description |
|---|---|
| Tab ID | The unique identifier for the tab. |
| Tab label | The label assigned to the tab. |
| Name | The name of the tab. |
| Tab type | The type of tab. |
| Document ID | The ID of the document the tab appears on. |
| Recipient ID | The ID of the recipient the tab is assigned to. |
| Page number | The page number where the tab appears. |
| X position | The horizontal position of the tab on the page, in pixels. |
| Y position | The vertical position of the tab on the page, in pixels. |
| Status | The tab's current status. |
| Locked | Indicates whether the tab is locked from editing. |
| Anchor string | The text string the tab is anchored to. |
| Anchor X offset | The horizontal offset from the anchor string, in pixels. |
| Anchor Y offset | The vertical offset from the anchor string, in pixels. |
| Value | The value entered in or selected for the tab. |
| Required | Indicates whether the recipient must complete the tab. |
Last updated: