> For the complete documentation index, see [llms.txt](https://docs.vida.id/identity-stack/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vida.id/identity-stack/sign/digital-signature/vsp-openapi/api-reference/download-signed-envelope.md).

# Download Signed Envelope

## Download Completed Document

This API can be used to retrieve a fully signed document, providing a downloadable, finalized copy for records.

***

### API Description

<mark style="color:blue;">`GET`</mark> `{environment-url}/document/external-api/rest/v1/envelope/{envelope_id}/signed-document`

***

#### Path Parameters

| Name                                           | Type | Description                              |
| ---------------------------------------------- | ---- | ---------------------------------------- |
| envelope\_id<mark style="color:red;">\*</mark> | UUID | The envelope ID from Create Envelope API |

***

### Headers

| Name                                            | Type   | Description                                                                                                                                                               |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Content-Type<mark style="color:red;">\*</mark>  | String | \*/\*                                                                                                                                                                     |
| Authorization<mark style="color:red;">\*</mark> | String | <p>Bearer Access Token<br><br>Get the access token by calling the</p><p><a href="/pages/XOKnwALziwtzopCd8Bb1#api-description"><strong>Authentication</strong></a> API</p> |

***

### Response Body

#### Document Download Successful

HTTP Status Code: `200`

Status : `SUCCESS`

&#x20;Response:

```json
binary resources
```

{% hint style="info" %}
If the envelope contains >1 documents, the binary file will be in ZIP file format, containing the signed documents. Otherwise, the binary file will be in PDF format
{% endhint %}

#### Bad Request - Envelope not been signed and completed

The envelope is not in signature completion state

HTTP Status Code: `400`

Status : `ERROR`

```json
{
    "message": "Unable to execute, the envelope is not in signature completion state.",
    "code": "ER.10114"
}
```

#### Forbidden

User does not have permission to operate this envelope

HTTP Status Code: `400`

Status : `ERROR`

```json
{
    "code":"MG.10379",
    "message":"Envelope Authorization Forbidden"
}
```