Docusign - Get envelope recipients action
The Get envelope recipients action retrieves the list of recipients for a given envelope, including signers, carbon copy recipients, and more. Refer to the Docusign EnvelopeRecipients: list API reference for more information.
Input
| Input field | Description |
|---|---|
| Envelope ID | Enter the ID of the Docusign envelope. |
| Include tabs | Enable to include tab data for each recipient in the response. |
Output
Docusign groups recipients by recipient type, and each type shares a common set of fields plus its own type-specific fields. Refer to the EnvelopeRecipients resource for the full field reference of each recipient type.
| Output field | Description |
|---|---|
| Current routing order | The routing order value of the current recipient, indicating the envelope was sent to this recipient but they haven't yet completed their action. |
| Recipient count | The number of recipients on the envelope. |
| Signers | The list of recipients who must sign, initial, date, or add information to the documents. |
| In person signers | The list of recipients who sign in person, with a Docusign user acting as a signing host in the same physical location as the signer. |
| Witnesses | The list of recipients who witness another recipient's signature. |
| Carbon copies | The list of recipients who receive a copy of the envelope but don't need to sign, initial, date, or add information to the documents. |
| Certified deliveries | The list of recipients who must receive the completed documents for the envelope to be completed, but don't need to sign, initial, date, or add information to the documents. |
| Agents | The list of recipients who can add name and email information for recipients that appear later in the routing order. |
| Editors | The list of recipients with the same management and access rights as the sender, who can edit the envelope, recipients, and tabs for the remaining recipients. |
| Intermediaries | The list of recipients who can optionally add name and email information for recipients at the same or a later point in the routing order. |
| Seals | The list of electronic seal recipients. An electronic seal represents an organization or government entity rather than an individual. |
| Notaries | The list of recipients who notarize another recipient's signature using Docusign eNotary. |
Recipient fields
Each recipient in the arrays above is an object that shares a common set of fields, such as Recipient ID, Recipient type, Status, Routing order, and Tabs. These are the same fields documented in Recipient fields on the Get envelope action, and each recipient's tabs use the same structure as Tab fields. Informational recipient types (Carbon copies, Certified deliveries, Agents, Editors, Intermediaries, Seals, and Notaries) return a subset of these fields.
Type-specific fields
Some recipient types include fields beyond the common set. In person signers use the host and signer fields below instead of the common Email and Name fields.
| Output field | Description |
|---|---|
| Is bulk recipient (Signers) | Indicates whether the recipient is part of a bulk send. |
| Recipient supplies tabs (Signers) | Indicates whether the recipient supplies their own tabs. |
| Require upload signature (Signers) | Indicates whether the recipient must upload a signature. |
| Host email (In person signers) | The email address of the Docusign user hosting the in-person signing session. |
| Host name (In person signers) | The name of the Docusign user hosting the in-person signing session. |
| Signer email (In person signers) | The email address of the in-person signer. |
| Signer name (In person signers) | The name of the in-person signer. |
| Witness for (Witnesses) | The recipient ID of the recipient the witness is witnessing for. |
| Witness for GUID (Witnesses) | The globally unique identifier (GUID) of the recipient the witness is witnessing for. |
Last updated: