> 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

# RequestStatus and RequestStatusEx

The RequestStatus and RequestStatusEx methods can be used to query the status of existing envelopes.

The RequestStatus method takes the element EnvelopeID for the envelope for which the status is requested. This Envelope ID must refer to an envelope created via the Create Envelope/CreateAndSendEnvelope method call.

### Schema

**RequestStatus**

![](/_fern-files/_img/6f41f2d7be8bd4727c647d5cd0a7465fba1a7c882a4d2eae0b56406bf954fcf3.webp)

**RequestStatusEx**

![](/_fern-files/docusign.docs.buildwithfern.com/5e3a62fbe4d15ad0fef12354f888d004feb9ca6c97c288e7d5213540f48c6447/docs/assets/soap/RequestStatusEx.png)

**`RequestStatus C#`**

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

// Request the status of that envelope
DocuSignWeb.EnvelopeStatus status = _apiClient.RequestStatus(eStatus.EnvelopeID);

// Display the status for the envelope
Console.WriteLine("Status for envelope ID {0} is {1}", eStatus.EnvelopeID, status.Status);
```

**`RequestStatus PHP`**

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

// Request the status of that envelope
$requestStatusparams = new RequestStatus();
$requestStatusparams->EnvelopeID = $createResult->EnvelopeID;
$result = $api->RequestStatus($requestStatusparams);
```

**`RequestStatusEx C#`**

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

// Request the status of that envelope
DocuSignWeb.EnvelopeStatus status = _apiClient.RequestStatusEx(eStatus.EnvelopeID);

// Confirm that the status of the envelope is sent
Console.WriteLine("Status for envelope ID {0} is {1}", eStatus.EnvelopeID, status.Status);
Console.WriteLine("Account status is {0}", status.RecipientStatuses[0].AccountStatus);
```

**`RequestStatusEx PHP`**

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

// Request the status of that envelope
$requestStatusExparams = new RequestStatusEx();
$requestStatusExparams->EnvelopeID = $createResult->EnvelopeID;
$result = $api->RequestExStatus($requestStatusparams);
```

| Name       | Schema Type | Description                                   |
| ---------- | ----------- | --------------------------------------------- |
| EnvelopeID | DSXId       | The Envelope ID for which to retrieve status. |

#### Sample Request XML

```
SOAPAction: "http://www.docusign.net/API/3.0/RequestStatus"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <RequestStatus xmlns="http://www.docusign.net/API/3.0">
      <EnvelopeID>string</EnvelopeID>
    </RequestStatus>
  </soap:Body>
</soap:Envelope>
```