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

# Pré-visualizar documento

> Retorna URL assinada do PDF renderizado com os campos dinâmicos atuais preenchidos (pré-assinatura).

Retorna uma URL assinada para download de uma pré-visualização do documento com os campos dinâmicos já renderizados (preenchidos) no PDF, **sem ser assinado ainda**. Se o documento já foi assinado, retorna a URL do documento assinado finalizado.

**Autenticação**: use apenas o `sessionToken` na URL.

## Parâmetros

<ParamField path="sessionToken" type="string" required>
  Token da sessão do signatário.
</ParamField>

## Respostas

<ResponseField name="previewUrl" type="string">
  URL assinada para download do PDF de pré-visualização (ou documento assinado se já finalizado). Válida por 15 minutos.
</ResponseField>

<ResponseField name="expiresAt" type="string">
  Timestamp de expiração da URL (ISO 8601).
</ResponseField>

## Erros

Veja [Autenticação e erros](/plataforma/assinatura-digital/api/erros-e-autenticacao).

* **404**: Session token inválido.
* **410**: Session token expirado.

<ResponseExample>
  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 200 OK
  Content-Type: application/json

  {
    "previewUrl": "https://storage.googleapis.com/bucket/preview-550e8400.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=...",
    "expiresAt": "2025-07-27T11:00:00.000Z"
  }
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
# Obter a URL
curl -X GET "https://signer.vcc-service.com/v1/sign/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.../preview" \
  | jq -r '.previewUrl' \
  > preview-url.txt

# Fazer download do PDF
curl $(cat preview-url.txt) -o documento-preview.pdf
```

## Importante

* **Antes de assinar**: a pré-visualização mostra os campos dinâmicos com seus valores atuais renderizados no PDF.
* **Após assinar**: retorna o PDF finalizado assinado (mesmo que [`GET /v1/sign/:sessionToken/signed-document`](/plataforma/assinatura-digital/api/get-sign-session-signed-document)).
* **URL expira em 15 minutos**: faça download imediatamente ou chame novamente para uma URL nova.

## Relacionado

* [`GET /v1/sign/:sessionToken`](/plataforma/assinatura-digital/api/get-sign-session) — obter arquivo original (não preenchido)
* [`POST /v1/sign/:sessionToken/sign`](/plataforma/assinatura-digital/api/post-sign) — assinar o documento
* [`GET /v1/sign/:sessionToken/signed-document`](/plataforma/assinatura-digital/api/get-sign-session-signed-document) — documento assinado