---
title: "Obtain preview link"
method: POST
path: "/e-signature-packages/{eSignaturePackageId}/signers/{id}/actions/obtain-preview-link"
tags: ["Signers - Actions"]
---

# Obtain preview link

`POST /e-signature-packages/{eSignaturePackageId}/signers/{id}/actions/obtain-preview-link`

Obtain a secure link to be used for previewing the document. This link can be embedded using an iframe or used directly via the browser. The package must be in a valid state for preview access.

## Request body

- object
  - `duration` string, required — Time span expressed as [vercel/ms](https://github.com/vercel/ms), with only string values accepted. There is a minimum of 5 mins and maximum of 1 year. (E.g. "2 days", "10h", "7d", without an time units, the default is milliseconds, i.e. "120" equals "120ms" )

## Response `200`

Secure link for previewing that is particular to the specified user

- object
  - `url` string, required
  - `shortUrl` string, required

---

[API](https://skmtc.net/pactima/apis/esignature-packages-api.md) · [All operations](https://skmtc.net/pactima/apis/esignature-packages-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pactima/esignature-packages-api/revisions/1570128383ef/schema)