---
title: "Verificar envelope multi-signatário"
method: GET
path: "/v1/verify/envelope/{envelopeId}"
tags: ["Verification"]
---

# Verificar envelope multi-signatário

`GET /v1/verify/envelope/{envelopeId}`

## Request

- Base URL: `https://api.signdocs.com.br`
- URL: `https://api.signdocs.com.br/v1/verify/envelope/{envelopeId}`
- Auth: none required

Consulta pública de um envelope multi-signatário. Retorna o status
do envelope, lista de signatários (com `evidenceId` para drill-down
em cada evidência), e URLs de download para artefatos consolidados
a nível de envelope.

- `downloads.combinedSignedPdf`: presente quando o envelope é um
  PDF e todos os signatários concluíram (PDF combinado com todas as
  assinaturas embutidas).
- `downloads.consolidatedSignature`: presente quando o envelope é
  um documento não-PDF assinado com certificado digital e todos os
  signatários concluíram. Contém o `.p7s` (PKCS#7 detached) com
  todos os `SignerInfo` consolidados em um único arquivo.

Envelopes criados com `signerConfidentiality: true` não expõem
signatários, contagens nem downloads aqui — nem após a conclusão.

## Path parameters

- `envelopeId` string, required

## Response `200`

Envelope encontrado.

- EnvelopeVerificationResponse: Resposta de verificação pública de envelope multi-signatário. Inclui status do envelope, lista de signatários e URLs de download consolidadas. Cada signatário traz o `evidenceId` da sua evidência individual para drill-down via `GET /v1/verify/{evidenceId}`. Em envelope com `signerConfidentiality: true`, a resposta confirma só o envelope (status, hash, emissor, datas): `signers`, `totalSigners`, `completedSessions` e `downloads` são omitidos, inclusive após a conclusão.
  - `signerConfidentiality` boolean, required: Envelope com confidencialidade entre signatários. Quando `true`, os campos de signatários, contagens e downloads não são devolvidos.
  - `envelopeId` string, required
  - `status` 'CREATED' | 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED', required: Status possíveis de um envelope.
  - `signingMode` 'PARALLEL' | 'SEQUENTIAL', required
  - `totalSigners` integer: Número total de signatários esperados no envelope.
  - `completedSessions` integer: Quantidade de sessões já concluídas.
  - `documentHash` string, required: Hash SHA-256 do documento original do envelope.
  - `tenantName` string: Nome da empresa/tenant que criou o envelope.
  - `tenantCnpj` string: CNPJ da empresa/tenant que criou o envelope.
  - `signers` object[]: Lista de signatários do envelope, ordenada por `signerIndex`.
    - `signerIndex` integer, required: Posição do signatário no envelope (1-based).
    - `displayName` string, required
    - `cpfCnpj` string: CPF ou CNPJ do signatário, **mascarado** (`123.***.***-09`), pela mesma razão da verificação por evidência.
    - `status` 'CREATED' | 'DOCUMENT_UPLOADED' | 'IN_PROGRESS' | 'COMPLETED' | 'CANCELLED' | 'EXPIRED' | 'FAILED', required: Status possíveis de uma transação.
    - `policyProfile` string: Perfil de política aplicado ao signatário (ex.: `DIGITAL_CERTIFICATE`, `OTP_ONLY`).
    - `evidenceId` string: Identificador da evidência individual deste signatário, presente apenas quando a sessão foi concluída. Use com `GET /v1/verify/{evidenceId}` para detalhes.
    - `completedAt` string, date-time
  - `downloads` object: Artefatos consolidados disponíveis para download. Apenas populado para envelopes em status `COMPLETED`. Os campos individuais são mutuamente exclusivos por formato do documento (PDF vs não-PDF).
    - `combinedSignedPdf` object: PDF combinado com todas as assinaturas digitais embutidas. Presente apenas quando o envelope é um PDF e todos os signatários já concluíram. Pode ser omitido para envelopes em andamento ou para envelopes não-PDF.
      - `url` string, uri, required
      - `filename` string, required
    - `consolidatedSignature` object: Arquivo PKCS#7 / CMS detached (`.p7s`) consolidado contendo todos os `SignerInfo` do envelope em um único arquivo. Presente apenas quando o envelope é um documento não-PDF assinado com certificado digital e todos os signatários concluíram. Pode ser verificado com: ``` openssl cms -verify -inform DER -in signature.p7s \ -CAfile icpbrasil-roots.pem ```
      - `url` string, uri, required
      - `filename` string, required
  - `createdAt` string, date-time, required
  - `completedAt` string, date-time: Data/hora em que o último signatário concluiu a sessão. Presente apenas quando o envelope está em status `COMPLETED`.

## Other responses

- `404`: Recurso não encontrado.

---

[API](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api.md) · [All operations](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signdocs/apis/signdocs-brasil-external-api/revisions/2d3805aed161?raw)