> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Envelopes

Get a list of envelopes that match your request.

**Note**: Using this action requires to use at least one of the following parameters:

* `From Date`
* `Envelope IDs`
* `Transaction IDs`

<Note>
  External Documentation

  To learn more, visit the [Docusign documentation](https://developers.docusign.com/docs/esign-rest-api/v2/reference/envelopes/envelopes/liststatuschanges/).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter      | Description                                                                                                                                                                                                                                                                                        |
  | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Envelope IDs   | Comma separated list of `envelopeId` values.                                                                                                                                                                                                                                                       |
  | From Date      | The date and time to start looking for status changes. This parameter is required unless the parameters `Envelope IDs` or `Transaction IDs` are set.                                                                                                                                               |
  | From To Status | The status value checked for in the `From Date` to `To Date` time period.<br /><br />For example:<br />\* If `Changed` is specified, then envelopes that changed status during the period will be returned.<br />\* If `Created` is specified, then envelopes created during the period are found. |
  | To Date        | The date and time to stop looking for status changes.                                                                                                                                                                                                                                              |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                 | Description                                                                                                                                                                                                                                                                                                                         |
  | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Authoritative Copy Status | The `Authoritative Copy Status` for the envelopes.                                                                                                                                                                                                                                                                                  |
  | Custom Field              | An envelope custom field name and value searched for in the envelopes.<br /><br />Format: `custom_envelope_field_name=desired_value`.<br /><br />Example: If you have an envelope custom field named "Region" and you want to search for all envelopes where the value is "West" you would use set this parameter to `Region=West`. |
  | Email                     | Get only envelopes sent by the account user with this email address.<br /><br />`User Name` must be given as well, and both `Email` and `User Name` must refer to an existing account user.                                                                                                                                         |
  | Status                    | A list of current envelope statuses to included in the response.                                                                                                                                                                                                                                                                    |
  | Transaction IDs           | A comma separated list of envelope `Transaction IDs`. If included, this is a list of envelope `Transaction IDs`.                                                                                                                                                                                                                    |
  | Username                  | Get only envelopes sent by the account user with this user name.<br /><br />`Email` must be given as well, and both `Email` and `User Name` must refer to an existing account user.                                                                                                                                                 |
</div>

## Example Output

```json theme={"dark"}
{
	"resultSetSize": "<string>",
	"totalSetSize": "<string>",
	"startPosition": "<string>",
	"endPosition": "<string>",
	"nextUri": "<string>",
	"previousUri": "<string>",
	"envelopes": [
		{
			"status": "<string>",
			"documentsUri": "<string>",
			"recipientsUri": "<string>",
			"attachmentsUri": "<string>",
			"envelopeUri": "<string>",
			"envelopeId": "<string>",
			"customFieldsUri": "<string>",
			"notificationUri": "<string>",
			"statusChangedDateTime": "2025-04-06T11:41:02.0170000Z",
			"documentsCombinedUri": "<string>",
			"certificateUri": "<string>",
			"templatesUri": "<string>"
		}
	]
}
```

## Workflow Library Example

[Get Envelopes with Docusign and Send Results Via Email](https://library.blinkops.com/workflows/get-envelopes-with-docusign-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/get-envelopes-with-docusign-and-send-results-via-email/canvas" />
</div>