> 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/remind-signer.md).

# Remind Signer

This endpoint can be used to initiate a reminder email to the unsigned recipient. Each recipient can be reminded once a day at most.

***

### API Description

<mark style="color:green;">`POST`</mark> `/core/external-api/rest/v1/envelope/{envelope_id}/remind-signature`

***

#### Headers

<table><thead><tr><th width="213">Name</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>Content-Type<mark style="color:red;">*</mark></td><td>String</td><td>application/json</td></tr><tr><td>Authorization<mark style="color:red;">*</mark></td><td>String</td><td>Bearer Access Token</td></tr></tbody></table>

#### Path Parameters

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

***

#### Response Body

#### Recipients Reminded Successfully

HTTP Status Code: `200`

Status : `SUCCESS`

```json
{
    "success": true,
    "data": {
        "remind_recipients": [
            {
                "email": "example@email.com"
            },
            {
                "email": "example2@email.com"
            }
        ]
    }
}
```

#### Bad Request - envelope is not in 'PENDING' state

The envelope must be in `PENDING` state for sending the reminder..

HTTP Status Code: `400`

Status : `ERROR`

```json
{
    "code": "MG.10303",    
    "message": "Unable to execute, The status of envelope must be `PENDING`."
}
```

#### Bad Request - Reminder already sent

The envelope is already in signed or completed state.

HTTP Status Code: `400`

Status : `ERROR`

```json
{
    "code": "AS.10541",
    "message": "You have already sent a reminder today. Please try again tomorrow."
}
```

#### Forbidden

User does not have permission to access.

HTTP Status Code: `403`

Status : `ERROR`

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