Verificar um documento selado

Qualquer pessoa pode conferir se um documento foi selado pela SuperSign, sem conta e sem API Key. É a mesma verificação que o QR code impresso na folha de assinaturas abre no validador.

A rota informa só se o documento existe e é autêntico, quando foi selado e o status. Ela não devolve o arquivo, nomes, e-mails ou outros dados de quem assinou.

Requisição

Parâmetro	Onde	Obrigatório	Descrição
`idOrHash`	caminho	sim	Id do documento (impresso no selado) ou o SHA-256 do PDF selado, em hexadecimal (64 caracteres)
`hash`	query	não	SHA-256 do arquivo que você tem em mãos, em hexadecimal. Quando informado, a resposta diz se ele confere com o selado

Resposta `200`

{
  "exists": true,
  "hashMatches": null,
  "sealedAt": "2026-09-01T12:00:00.000Z",
  "status": "SEALED",
  "environment": "live",
  "legalValidity": true
}

Campo	Descrição
`exists`	`true` quando há documento selado com esse id ou hash
`hashMatches`	`true`/`false` quando `hash` foi informado; `null` quando não foi, ou quando o documento não existe
`sealedAt`	Data e hora da selagem (UTC), ou `null` em documentos antigos sem essa informação
`status`	Status do documento
`environment`	`live` (produção) ou `sandbox`
`legalValidity`	`false` na Sandbox, cujos documentos não têm validade jurídica

Documento inexistente também responde 200, com exists: false. Um hash fora do formato SHA-256 em hexadecimal responde 400.

Limite

20 requisições por minuto por IP (endereços IPv6 agrupados por /64). Acima disso, a resposta é 429.

Quer ver o documento e os signatários?

Envie o próprio PDF no validador. Quem tem o arquivo em mãos recebe também os signatários. Para integrações, use GET /v4/api/documents/{documentId}/validation com a API Key da conta dona do documento.

Esta é a única operação da API pública que não usa API Key: não envie Authorization, e o teto de requisições por conta não se aplica a ela. Mudanças nela são registradas no Changelog.

Requisição#

Resposta 200#

Limite#

Quer ver o documento e os signatários?#

Requisição

Resposta `200`

Limite

Quer ver o documento e os signatários?