> ## 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.

# Baixar relatório do envelope

> Retorna um PDF com o relatório/comprovante do envelope (status, histórico, arquivos, assinaturas).

Retorna um PDF contendo o relatório/comprovante completo do envelope. Inclui:

* Dados gerais do envelope
* Status de cada signatário
* Histórico de ações com timestamps e IPs
* Arquivos originais e assinados
* Evidências (fotos de liveness, documentoscopia, se capturadas)

Diferente de [`GET .../signed-document`](/plataforma/assinatura-digital/api/get-envelope-signed-document), que retorna o PDF **assinado** em si, este endpoint retorna um **comprovante** com informações administrativas.

**Autenticação**: `x-api-key` no header. Também aceita `Authorization: Bearer`.

## Parâmetros

<ParamField path="uuid" type="string" required>
  UUID do envelope.
</ParamField>

## Respostas

Resposta binária `application/pdf`. O PDF é gerado dinamicamente e retornado no corpo. Use o header `Content-Disposition` para saber o nome sugerido do arquivo.

## Erros

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

* **404**: Envelope não encontrado.

<ResponseExample>
  ```
  HTTP/1.1 200 OK
  Content-Type: application/pdf
  Content-Disposition: attachment; filename="relatorio-550e8400-e29b-41d4.pdf"
  Content-Length: 150000

  %PDF-1.4
  ...conteúdo binário do PDF...
  ```
</ResponseExample>

## Exemplo

```bash theme={"theme":"catppuccin-latte"}
curl -X GET "https://api.valid.com/signer/v1/envelopes/550e8400-e29b-41d4-a716-446655440000/report" \
  -H "x-api-key: YOUR_API_KEY" \
  -o relatorio.pdf
```

## Importante

* **Relatório, não assinado**: este não é o PDF do documento que foi assinado. É um comprovante administrativo.
* **Disponível em qualquer estado**: pode ser gerado mesmo que o envelope ainda esteja em assinatura (conterá status parcial).
* **Binário**: não é JSON. Trate como arquivo de download.

## Distinções

| Endpoint | O que retorna | Quando usar |
| :- | :- | :- |
| `GET .../report` | PDF com relatório/comprovante administrativo | Prova de workflow, evidências, auditoria |
| `GET .../signed-document` | PDF do documento **assinado** em si | Compartilhar o documento final com signatários/arquivar |

## Relacionado

* [`GET .../signed-document`](/plataforma/assinatura-digital/api/get-envelope-signed-document) — baixar o PDF assinado
* [`GET /signer/v1/envelopes/:uuid`](/plataforma/assinatura-digital/api/get-envelope-by-id) — dados estruturados do envelope


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.