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

# Obter envelope

> Retorna detalhes completos de um envelope: dados, signatários, arquivo e assinatura.

Retorna todas as informações de um envelope, incluindo signatários, arquivo e registros de assinatura.

## Parâmetros

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

## Respostas

<ResponseField name="envelope" type="object">
  Dados do envelope.

  <Expandable title="Propriedades de envelope">
    <ResponseField name="uuid" type="string">
      UUID do envelope.
    </ResponseField>

    <ResponseField name="externalCode" type="string">
      Código externo do seu sistema.
    </ResponseField>

    <ResponseField name="title" type="string">
      Título do envelope.
    </ResponseField>

    <ResponseField name="state" type="string">
      Estado: `CREATED`, `AWAITING_SIGNATURE`, `SIGNING_IN_PROGRESS`, `FINISHED`, `CANCELLED`, `EXPIRED`, `REFUSED`.
    </ResponseField>

    <ResponseField name="signingMode" type="string">
      Modo: `sequential` ou `parallel`.
    </ResponseField>

    <ResponseField name="dueDate" type="string">
      Data limite (ISO 8601).
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Timestamp de criação (ISO 8601).
    </ResponseField>

    <ResponseField name="finishedAt" type="string">
      Timestamp de finalização (ISO 8601), se finalizado.
    </ResponseField>

    <ResponseField name="refusedAt" type="string">
      Timestamp de recusa (ISO 8601), se recusado.
    </ResponseField>

    <ResponseField name="refusalReason" type="string">
      Motivo da recusa (texto), se recusado.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="signers" type="array">
  Lista de signatários com status.

  <Expandable title="Propriedades de signers[]">
    <ResponseField name="uuid" type="string">
      UUID do signatário.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome completo.
    </ResponseField>

    <ResponseField name="email" type="string">
      E-mail (mascarado parcialmente).
    </ResponseField>

    <ResponseField name="cpf" type="string">
      CPF (mascarado parcialmente).
    </ResponseField>

    <ResponseField name="state" type="string">
      Estado do signatário: `PENDING`, `SIGNED`, `REFUSED`, `EXPIRED`.
    </ResponseField>

    <ResponseField name="signedAt" type="string">
      Timestamp da assinatura (ISO 8601), se assinado.
    </ResponseField>

    <ResponseField name="queueOrder" type="integer">
      Ordem na fila (apenas se `signingMode` = `sequential`).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="file" type="object">
  Documento do envelope.

  <Expandable title="Propriedades de file">
    <ResponseField name="uuid" type="string">
      UUID do arquivo.
    </ResponseField>

    <ResponseField name="filename" type="string">
      Nome do arquivo.
    </ResponseField>

    <ResponseField name="mime" type="string">
      MIME type (ex: `application/pdf`).
    </ResponseField>

    <ResponseField name="sizeBytes" type="integer">
      Tamanho em bytes.
    </ResponseField>

    <ResponseField name="downloadUrl" type="string">
      URL assinada para download (válida por 15 minutos). Aponta para o PDF em branco/original (não o assinado).
    </ResponseField>

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

<ResponseField name="signature" type="object">
  Informações da assinatura (presente apenas se assinado).

  <Expandable title="Propriedades de signature">
    <ResponseField name="uuid" type="string">
      UUID do registro de assinatura.
    </ResponseField>

    <ResponseField name="standardName" type="string">
      Padrão de assinatura: `PAdES` (avançado) ou `Eletronic` (simples).
    </ResponseField>

    <ResponseField name="signedAt" type="string">
      Timestamp da assinatura (ISO 8601).
    </ResponseField>

    <ResponseField name="signedHashSha256" type="string">
      Hash SHA-256 do conteúdo assinado.
    </ResponseField>

    <ResponseField name="sizeBytes" type="integer">
      Tamanho do PDF assinado em bytes.
    </ResponseField>

    <ResponseField name="signedFileUrl" type="string">
      URL assinada para download do PDF final (válida por 15 minutos).
    </ResponseField>

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

## Erros

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

* **401**: API key/Bearer token inválido.
* **404**: Envelope não encontrado.

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

  {
    "envelope": {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "externalCode": "CONT-2025-001",
      "title": "Contrato de Serviços",
      "state": "FINISHED",
      "signingMode": "sequential",
      "dueDate": "2025-12-31T23:59:59Z",
      "createdAt": "2025-07-27T10:30:00.000Z",
      "finishedAt": "2025-07-27T15:45:30.000Z"
    },
    "signers": [
      {
        "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "name": "João Silva",
        "email": "jo***@empresa.com",
        "cpf": "123.456.789-**",
        "state": "SIGNED",
        "signedAt": "2025-07-27T15:20:00.000Z",
        "queueOrder": 1
      },
      {
        "uuid": "6ba7b811-9dad-11d1-80b4-00c04fd430c8",
        "name": "Maria Santos",
        "email": "ma***@empresa.com",
        "cpf": "987.654.321-**",
        "state": "SIGNED",
        "signedAt": "2025-07-27T15:45:30.000Z",
        "queueOrder": 2
      }
    ],
    "file": {
      "uuid": "6ba7b812-9dad-11d1-80b4-00c04fd430c8",
      "filename": "contrato.pdf",
      "mime": "application/pdf",
      "sizeBytes": 250000,
      "downloadUrl": "https://storage.googleapis.com/bucket/file.pdf?X-Goog-Algorithm=...",
      "downloadUrlExpiresAt": "2025-07-27T11:00:00.000Z"
    },
    "signature": {
      "uuid": "6ba7b813-9dad-11d1-80b4-00c04fd430c8",
      "standardName": "PAdES",
      "signedAt": "2025-07-27T15:45:30.000Z",
      "signedHashSha256": "abc123def456...",
      "sizeBytes": 275000,
      "signedFileUrl": "https://storage.googleapis.com/bucket/signed.pdf?X-Goog-Algorithm=...",
      "signedFileUrlExpiresAt": "2025-07-27T11:00:00.000Z"
    }
  }
  ```

  ```json theme={"theme":"catppuccin-latte"}
  HTTP/1.1 404 Not Found
  Content-Type: application/json

  {
    "statusCode": 404,
    "message": "Record not found"
  }
  ```
</ResponseExample>

## Exemplo

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

## Relacionado

* [`GET /v1/envelopes`](/plataforma/assinatura-digital/api/get-envelopes) — listar envelopes
* [`GET /v1/envelopes/:uuid/history`](/plataforma/assinatura-digital/api/get-envelope-history) — histórico de auditoria
* [`GET /v1/envelopes/:uuid/signed-document`](/plataforma/assinatura-digital/api/get-envelope-signed-document) — URL de download direto