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

# Retrieve a signing token

Generates a new signing token that can be used to access the envelope in the context of a specific recipient. If the recipient has already completed their required actions, the token will provide read-only access to view and download the finalised documents.

This endpoint is typically used in workflows where the application needs to manage the delivery of signing links manually — especially for muted recipients.

If a recipient attempts to access an envelope using an expired signing token, they may choose to request a new one from Annature. When the recipient is **not muted**, a new email or SMS will be sent based on their selected method. If the recipient **is muted**, no communication will be sent and a `recipient_token_request` webhook event will be triggered instead. You must listen to this event and handle link distribution yourself.

## Parameters

<ParamField path="token_duration" type="optional">
  The number of days the generated token should remain valid. Must be between 1 and 90 days. Default is 7 days.
</ParamField>

<RequestExample>
  ```bash Endpoint theme={null}
  GET /v1/recipients/:id/token
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "endpoint": "https://annature..",
    "expiration": "2019-12-17T05:30:00Z"
  }
  ```
</ResponseExample>