SuperSign - API Oficial
  1. Introdução
  • SuperSign API Pública
    • Introdução
      • Crie seu primeiro envelope no Sandbox
      • Integrar com IA
      • Testar a API no Postman
      • Paginação e filtros
      • Catálogo de erros
      • Receitas em Node.js, PHP e Python
      • Changelog
      • Idempotência e erros
      • Estados do envelope
      • Webhooks
      • Limites de requisição
      • Criar um envelope a partir de um modelo
      • Gerar cliente com OpenAPI
      • Evento ENVELOPE_SENT
      • Evento SIGNATORY_SIGNED
      • Evento ENVELOPE_COMPLETED
      • Evento ENVELOPE_VOIDED
      • Evento ENVELOPE_EXPIRED
      • Segurança e verificação
      • Entregas, retentativas e reenvio
      • Testar na Sandbox e automatizar
      • Conceitos da API V4
      • Posicionar campos por texto âncora
      • Verificar um documento selado
      • Evento PARTICIPANT_DECLINED
      • Evento EMAIL_BOUNCED
      • Entrega do convite pela integração
      • Evento PARTICIPANT_VIEWED
      • Guia completo da API V4
      • Assinatura embutida (sob consulta)
      • Salvar os documentos assinados no seu Drive
    • Referência da API
      • Conta
        • Consultar a conta da integração
        • Consultar capacidades da integração
        • Consultar o catálogo de capacidades
        • Listar chamadas da própria chave
        • Consultar consumo do ciclo
        • Validar a chave de API
      • Envelopes
        • Excluir rascunho de envelope
        • Consultar histórico do envelope
        • Criar e enviar envelope numa chamada
        • Gerar URL de download do envelope em ZIP
        • Duplicar envelope
        • Criar rascunho de envelope
        • Listar envelopes
        • Atualizar configurações do envelope
        • Enviar envelope
        • Consultar envelope
        • Mover envelope para outra pasta
        • Anular envelope
      • Participantes
        • Listar participantes do envelope
        • Aprovar participante aprovador
        • Recusar como participante aprovador
        • Corrigir contato do participante
        • Consultar link de assinatura
        • Sincronizar participantes
        • Enviar lembrete ao participante
      • Documentos
        • Listar documentos do envelope
        • Substituir campos do documento
        • Listar campos do documento
        • Confirmar o PDF convertido de um DOCX
        • Validar um documento selado
        • Reordenar documentos do envelope
        • Consultar o tamanho das páginas
        • Achar texto (âncora) no documento
        • Verificar um documento selado
        • Baixar o PDF de exemplo
        • Adicionar documento ao envelope
        • Gerar URL de download do documento
      • Contatos
        • Atualizar contato parcialmente
        • Listar envelopes do contato
        • Listar listas de contatos
        • Consultar lista de contatos
        • Criar contato
        • Listar contatos
        • Consultar contato
        • Atualizar contato
        • Excluir contato
      • Equipe
        • Listar grupos da conta
        • Listar membros da conta
      • Pastas
        • Listar conteúdo da pasta
        • Consultar acesso da pasta
        • Excluir pasta
        • Renomear pasta
        • Mover pasta
        • Listar todas as pastas
        • Criar pasta
      • Convites
        • Listar convites da conta
      • Webhooks
        • Excluir webhook
        • Listar entregas de um webhook
        • Detalhar uma entrega de webhook
        • Reenviar uma entrega de webhook
        • Girar o segredo de assinatura do webhook
        • Enviar um evento de teste para o webhook
        • Atualizar webhook
        • Criar webhook
        • Listar webhooks
      • Modelos
        • Listar modelos
        • Consultar modelo
        • Criar envelope a partir de modelo
        • Criar modelo em rascunho
        • Editar título e descrição do modelo
        • Consultar processamento do documento do modelo
        • Ativar modelo
        • Duplicar modelo
        • Enviar documentos do modelo
        • Definir vagas do modelo
        • Posicionar campos no documento do modelo
        • Apagar modelo em rascunho
        • Reordenar documentos do modelo
        • Remover documento do modelo
        • Definir cópias do modelo
        • Achar texto (âncora) no documento do modelo
      • Auditoria e relatórios
        • Relatório de consumo do plano
        • Relatório de recusas, anulações e prazos vencidos
        • Listar envelopes anulados
        • Relatório de envelopes
        • Relatório de uso por grupo
      • Etiquetas
        • Aplicar etiqueta ao envelope
        • Remover etiqueta do envelope
        • Listar etiquetas da conta
  1. Introdução

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 consulta o registro de selagem e pode comparar o SHA-256 do PDF informado. Ela não valida criptograficamente as assinaturas do arquivo nem devolve o PDF, nomes, e-mails ou outros dados de quem assinou.

Requisição#

ParâmetroOndeObrigatórioDescrição
idOrHashcaminhosimId do documento (impresso no selado) ou o SHA-256 do PDF selado, em hexadecimal (64 caracteres)
hashquerynãoSHA-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
}
CampoDescrição
existstrue quando há documento selado com esse id ou hash
hashMatchestrue/false quando hash foi informado; null quando não foi, ou quando o documento não existe
sealedAtData e hora da selagem (UTC), ou null em documentos antigos sem essa informação
statusStatus do documento
environmentlive (fora da Sandbox) ou sandbox
legalValidityfalse na Sandbox. É um ambiente de testes; e-mails de homologação podem chegar a endereços reais, mas os documentos de exemplo não devem ser usados como prova ou acordo. Fora da Sandbox, true apenas quando há registro selado e o hash informado, se houver, confere. Não substitui a validação criptográfica das assinaturas do PDF
Documento inexistente também responde 200, com exists: false e legalValidity: false. Hash divergente mantém exists: true, mas devolve hashMatches: false e legalValidity: 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.
Modificado em 2026-11-15 14:38:01
Página anterior
Posicionar campos por texto âncora
Próxima página
Evento PARTICIPANT_DECLINED
Built with