---
title: "Verifica as assinaturas digitais de um documento"
method: POST
path: "/verifications/verify"
tags: ["API"]
---

# Verifica as assinaturas digitais de um documento

`POST /verifications/verify`

Recebe um documento via multipart/form-data e retorna o resultado da verificação das assinaturas presentes no documento. A resposta inclui um 'verificationId' que pode ser utilizado para gerar o relatório qualificado.

## Response `200`

Verificação realizada com sucesso. Retorna o resultado da verificação das assinaturas do documento. Documento sem assinaturas retorna 200, com resultado indicando documento não assinado.

- object — Resultado da verificação de assinaturas de um documento.
  - `verificationId` string, uuid — Identificador gerado para esta verificação. Pode ser utilizado para gerar o relatório qualificado do documento.
  - `document` Document — Informações do documento
    - `type` 'PDF' | 'CMS' | 'XML' — Formato detectado do documento.
    - `name` string — Nome do documento.
    - `size` integer — Tamanho do documento em bytes.
    - `hash` Hash — Resumo criptográfico (hash)
      - `value` string — Valor do hash codificado em hexadecimal.
      - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
  - `date` integer — Unix timestamp (em milissegundos) da realização da verificação.
  - `verificationResult` VerificationResult — Resultado da verificação de assinaturas de um documento.
    - `status` Info — Item de informação, composto por mensagem e status.
      - `message` string — Mensagem descritiva da informação.
      - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
    - `extraInfo` Info[]
      - `message` string — Mensagem descritiva da informação.
      - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
    - `signatures` Signature[] — Resultado da verificação de cada assinatura encontrada no documento.
      - `status` Info — Item de informação, composto por mensagem e status.
        - `message` string — Mensagem descritiva da informação.
        - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
      - `extraInfo` Info[]
        - `message` string — Mensagem descritiva da informação.
        - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
      - `signatureCertificate` SignatureCertificate — Certificado do assinante.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `name` string — Nome do titular do certificado.
        - `issuer` string — Nome do emissor do certificado.
        - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
        - `validity` object — Período de validade de um certificado.
          - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
          - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
        - `serialNumber` string — Número de série do certificado.
        - `cpf` string — CPF do titular, quando presente no certificado.
        - `cnpj` string — CNPJ da organização, quando presente no certificado.
        - `email` string — E-mail do titular, quando presente no certificado.
        - `organization` string — Organização do titular, quando presente no certificado.
        - `type` string — Tipo do certificado.
        - `keyUsages` string[] — Usos de chave (key usages) declarados no certificado.
        - `extendedKeyUsages` string[] — Usos estendidos de chave (extended key usages) declarados no certificado.
      - `certificateChain` Certificate[] — Cadeia de certificação do certificado do assinante.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `name` string — Nome do titular do certificado.
        - `issuer` string — Nome do emissor do certificado.
        - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
        - `validity` object — Período de validade de um certificado.
          - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
          - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
        - `serialNumber` string — Número de série do certificado.
      - `signatureStamps` Stamp[] — Carimbos do tempo de assinatura.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `date` integer — Unix timestamp (em milissegundos) da emissão do carimbo do tempo.
        - `hash` Hash — Resumo criptográfico (hash)
          - `value` string — Valor do hash codificado em hexadecimal.
          - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
        - `signatureSuite` string — Suíte de assinatura utilizada no carimbo.
        - `policy` string — Política de carimbo do tempo.
        - `serialNumber` string — Número de série do carimbo do tempo.
        - `stampCertificate` StampCertificate — Certificado da autoridade emissora do carimbo do tempo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
        - `certificateChain` Certificate[] — Cadeia de certificação do certificado do carimbo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
      - `referenceStamps` Stamp[] — Carimbos do tempo de referência. Presente em assinaturas CMS e XML.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `date` integer — Unix timestamp (em milissegundos) da emissão do carimbo do tempo.
        - `hash` Hash — Resumo criptográfico (hash)
          - `value` string — Valor do hash codificado em hexadecimal.
          - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
        - `signatureSuite` string — Suíte de assinatura utilizada no carimbo.
        - `policy` string — Política de carimbo do tempo.
        - `serialNumber` string — Número de série do carimbo do tempo.
        - `stampCertificate` StampCertificate — Certificado da autoridade emissora do carimbo do tempo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
        - `certificateChain` Certificate[] — Cadeia de certificação do certificado do carimbo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
      - `archiveStamps` Stamp[] — Carimbos do tempo de arquivamento. Presente em assinaturas CMS e XML.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `date` integer — Unix timestamp (em milissegundos) da emissão do carimbo do tempo.
        - `hash` Hash — Resumo criptográfico (hash)
          - `value` string — Valor do hash codificado em hexadecimal.
          - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
        - `signatureSuite` string — Suíte de assinatura utilizada no carimbo.
        - `policy` string — Política de carimbo do tempo.
        - `serialNumber` string — Número de série do carimbo do tempo.
        - `stampCertificate` StampCertificate — Certificado da autoridade emissora do carimbo do tempo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
        - `certificateChain` Certificate[] — Cadeia de certificação do certificado do carimbo.
          - `status` Info — Item de informação, composto por mensagem e status.
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `extraInfo` Info[]
            - `message` string — Mensagem descritiva da informação.
            - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
          - `name` string — Nome do titular do certificado.
          - `issuer` string — Nome do emissor do certificado.
          - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
          - `validity` object — Período de validade de um certificado.
            - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
            - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
          - `serialNumber` string — Número de série do certificado.
      - `format` 'PDF' | 'PAdES' | 'CMS' | 'CAdES' | 'XAdES' | 'XML' — Formato da assinatura.
      - `filter` string — Filter da assinatura. Disponível somente para assinaturas em documentos PDF.
      - `subFilter` string — SubFilter da assinatura. Disponível somente para assinaturas em documentos PDF.
      - `date` integer — Unix timestamp (em milissegundos) disponível mais próximo da realização da assinatura.
      - `originalHash` Hash — Resumo criptográfico (hash)
        - `value` string — Valor do hash codificado em hexadecimal.
        - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
      - `signatureAlgorithm` string — Algoritmo de assinatura utilizado.
      - `hashAlgorithm` string — Algoritmo de hash utilizado na assinatura.
      - `restrictionType` 'NENHUMA_RESTRICAO' | 'PERMITIR_COMENTARIOS_E_PREENCHIMENTO_FORMULARIOS' | 'PERMITIR_SOMENTE_PREENCHIMENTO_FORMULARIOS' | 'DESABILITAR_QUALQUER_ALTERACAO' — Tipo de restrição de alterações do documento após a assinatura. Disponível somente para assinaturas em documentos PDF.
      - `icpBrasil` boolean — Indica se os itens utilizados para assinatura pertencem à hierarquia ICP-Brasil.
      - `fileName` string — Nome do arquivo assinado.
      - `fileInfo` string — Informações do arquivo assinado.
      - `metadata` object — Metadados associados à assinatura, no formato chave-valor. Disponível somente para assinaturas em documentos PDF.
      - `signatureField` string — Nome do campo de assinatura no documento. Disponível somente para assinaturas em documentos PDF.
    - `stamps` Stamp[] — Carimbos do tempo aplicados ao documento (não vinculados a uma assinatura específica).
      - `status` Info — Item de informação, composto por mensagem e status.
        - `message` string — Mensagem descritiva da informação.
        - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
      - `extraInfo` Info[]
        - `message` string — Mensagem descritiva da informação.
        - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
      - `date` integer — Unix timestamp (em milissegundos) da emissão do carimbo do tempo.
      - `hash` Hash — Resumo criptográfico (hash)
        - `value` string — Valor do hash codificado em hexadecimal.
        - `algorithm` string — Algoritmo utilizado para o cálculo do hash.
      - `signatureSuite` string — Suíte de assinatura utilizada no carimbo.
      - `policy` string — Política de carimbo do tempo.
      - `serialNumber` string — Número de série do carimbo do tempo.
      - `stampCertificate` StampCertificate — Certificado da autoridade emissora do carimbo do tempo.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `name` string — Nome do titular do certificado.
        - `issuer` string — Nome do emissor do certificado.
        - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
        - `validity` object — Período de validade de um certificado.
          - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
          - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
        - `serialNumber` string — Número de série do certificado.
      - `certificateChain` Certificate[] — Cadeia de certificação do certificado do carimbo.
        - `status` Info — Item de informação, composto por mensagem e status.
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `extraInfo` Info[]
          - `message` string — Mensagem descritiva da informação.
          - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.
        - `name` string — Nome do titular do certificado.
        - `issuer` string — Nome do emissor do certificado.
        - `icpBrasil` boolean — Indica se o certificado pertence à hierarquia ICP-Brasil.
        - `validity` object — Período de validade de um certificado.
          - `notBefore` integer — Unix timestamp (em milissegundos) do início da validade do certificado.
          - `notAfter` integer — Unix timestamp (em milissegundos) do fim da validade do certificado.
        - `serialNumber` string — Número de série do certificado.
    - `verifications` Info[] — Lista das verificações realizadas sobre o documento e seus resultados.
      - `message` string — Mensagem descritiva da informação.
      - `status` 'VALID' | 'INFO' | 'WARN' | 'INDETERMINATE' | 'ERROR' — Status da informação. VALID - item válido; INFO - item contém informação; WARN - item possui alerta; INDETERMINATE - não foi possível determinar a validade do item; ERROR - item possui erro.

## Other responses

- `400` — Retorno de erro da aplicação

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/versions/c87e026e87ac/schema)