> You are reading the Docusign Developer Documentation. For clean Markdown of any page, append .md to the page URL.
>
> Documentation indexes by section:
> - APIs and SDKs: https://docusign.docs.buildwithfern.com/docs/llms.txt
> - Platform 101: https://docusign.docs.buildwithfern.com/platform/llms.txt
> - Extension Apps: https://docusign.docs.buildwithfern.com/extension-apps/llms.txt
> - Docusign CLI: https://docusign.docs.buildwithfern.com/docusign-cli/llms.txt
>
> Authentication (OAuth, JWT Grant, M2M): https://docusign.docs.buildwithfern.com/platform/auth
> Webhooks and Connect: https://docusign.docs.buildwithfern.com/platform/webhooks
>
> OpenAPI specifications: https://docusign.docs.buildwithfern.com/openapi.json
> MCP server: https://docusign.docs.buildwithfern.com/_mcp/server

# RequestEnvelope

The RequestEnvelope call returns an API Envelope object containing all the data of an envelope. The envelope must be owned by the API user.

**`C#`**

```csharp title="C#"
// Create and send envelope as shown in linked code
DocuSignWeb.EnvelopeStatus status = <create and send envelope>;

// Call to request the envelope with the envelope's ID
DocuSignWeb.Envelope returnEnvelope = _apiClient.RequestEnvelope(status.EnvelopeID, false);

// Display information about the return envelope
Console.WriteLine("Return envelope has a subject of \"{0}\"", returnEnvelope.Subject);
```

**`PHP`**

```php title="PHP"
// Create and send an envelope as shown in linked code
$response = <create amd send envelope>;
$createResult = $response->CreateAndSendEnvelopeResult;

// Request envelope with envelope id
$requestEnvelopeparams = new RequestEnvelope();
$requestEnvelopeparams->EnvelopeID = $createResult->EnvelopeID;
$requestEnvelopeparams->IncludeDocumentBytes = false;
$response = $api->RequestEnvelope($requestEnvelopeparams);
```

| Name                 | Schema Type | Description                                                                     |
| -------------------- | ----------- | ------------------------------------------------------------------------------- |
| EnvelopeID           | String      | The envelope ID of the user’s envelope                                          |
| IncludeDocumentBytes | Boolean     | If set to “true” the document bytes are returned with the envelope information. |

The response to the RequestEnvelope call is:

| Name     | Schema Type | Description                   |
| -------- | ----------- | ----------------------------- |
| Envelope | complexType | A complex API Envelope object |

### Additional Errors for RequestEnvelope

In addition to the normal authentication check errors, the following error is also added.

* User_Lacks-Permissions – The user does not own have permission to access the envelope.
* Envelope_Does_Not_Exist – Invalid envelope ID passed.

#### Schema for RequestEnvelope

```
  <xs:element name="RequestEnvelope">
    <xs:complexType>
      <xs:all>
        <xs:element name="EnvelopeID" type="dsx:DSXId" />
        <xs:element name="IncludeDocumentBytes" type="xs:boolean" />
      </xs:all>
    </xs:complexType>
  </xs:element>
```