v1

latestOpenAPI 3.0.0MIT2026-08-0414772502.0 KB
API

Verifica as assinaturas digitais de um documento

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.

post/verifications/verify

Response

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.

verificationIdstring uuid

Identificador gerado para esta verificação. Pode ser utilizado para gerar o relatório qualificado do documento.

dateinteger

Unix timestamp (em milissegundos) da realização da verificação.

Example response

{
  "verificationId": "a0089a7c-3f15-48d2-995a-6f59ed79f824",
  "document": {
    "type": "PDF",
    "name": "contrato.pdf",
    "size": 524288,
    "hash": {
      "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
      "algorithm": "SHA-256"
    }
  },
  "date": 1698912385000,
  "verificationResult": {
    "status": {
      "message": "Assinatura aprovada",
      "status": "VALID"
    },
    "extraInfo": [
      {
        "message": "Assinatura aprovada",
        "status": "VALID"
      }
    ],
    "signatures": [
      {
        "status": {
          "message": "Assinatura aprovada",
          "status": "VALID"
        },
        "extraInfo": [
          {
            "message": "Assinatura aprovada",
            "status": "VALID"
          }
        ],
        "signatureCertificate": {
          "status": {
            "message": "Assinatura aprovada",
            "status": "VALID"
          },
          "extraInfo": [
            {
              "message": "Assinatura aprovada",
              "status": "VALID"
            }
          ],
          "name": "AC BRY SSL",
          "issuer": "Autoridade Certificadora Raiz Brasileira v10",
          "icpBrasil": true,
          "validity": {
            "notBefore": 1640995200000,
            "notAfter": 1735689600000
          },
          "serialNumber": "2A1B3C4D5E6F",
          "cpf": "12345678901",
          "cnpj": "12345678000199",
          "email": "joao.silva@bry.com.br",
          "organization": "BRY TECNOLOGIA S.A.",
          "type": "A3",
          "keyUsages": [
            "DIGITAL_SIGNATURE",
            "NON_REPUDIATION"
          ],
          "extendedKeyUsages": [
            "KEY_USAGE_CLIENT_AUTH"
          ]
        },
        "certificateChain": [
          {
            "status": {
              "message": "Assinatura aprovada",
              "status": "VALID"
            },
            "extraInfo": [
              {
                "message": "Assinatura aprovada",
                "status": "VALID"
              }
            ],
            "name": "AC BRY SSL",
            "issuer": "Autoridade Certificadora Raiz Brasileira v10",
            "icpBrasil": true,
            "validity": {
              "notBefore": 1640995200000,
              "notAfter": 1735689600000
            },
            "serialNumber": "2A1B3C4D5E6F"
          }
        ],
        "signatureStamps": [
          {
            "status": {
              "message": "Assinatura aprovada",
              "status": "VALID"
            },
            "extraInfo": [
              {
                "message": "Assinatura aprovada",
                "status": "VALID"
              }
            ],
            "date": 1698912385000,
            "hash": {
              "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
              "algorithm": "SHA-256"
            },
            "signatureSuite": "SHA256withRSA",
            "policy": "2.16.76.1.6.6",
            "serialNumber": "123456789",
            "stampCertificate": {
              "status": {
                "message": "Assinatura aprovada",
                "status": "VALID"
              },
              "extraInfo": [
                {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                }
              ],
              "name": "AC BRY SSL",
              "issuer": "Autoridade Certificadora Raiz Brasileira v10",
              "icpBrasil": true,
              "validity": {
                "notBefore": 1640995200000,
                "notAfter": 1735689600000
              },
              "serialNumber": "2A1B3C4D5E6F"
            },
            "certificateChain": [
              {
                "status": {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                },
                "extraInfo": [
                  {
                    "message": "Assinatura aprovada",
                    "status": "VALID"
                  }
                ],
                "name": "AC BRY SSL",
                "issuer": "Autoridade Certificadora Raiz Brasileira v10",
                "icpBrasil": true,
                "validity": {
                  "notBefore": 1640995200000,
                  "notAfter": 1735689600000
                },
                "serialNumber": "2A1B3C4D5E6F"
              }
            ]
          }
        ],
        "referenceStamps": [
          {
            "status": {
              "message": "Assinatura aprovada",
              "status": "VALID"
            },
            "extraInfo": [
              {
                "message": "Assinatura aprovada",
                "status": "VALID"
              }
            ],
            "date": 1698912385000,
            "hash": {
              "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
              "algorithm": "SHA-256"
            },
            "signatureSuite": "SHA256withRSA",
            "policy": "2.16.76.1.6.6",
            "serialNumber": "123456789",
            "stampCertificate": {
              "status": {
                "message": "Assinatura aprovada",
                "status": "VALID"
              },
              "extraInfo": [
                {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                }
              ],
              "name": "AC BRY SSL",
              "issuer": "Autoridade Certificadora Raiz Brasileira v10",
              "icpBrasil": true,
              "validity": {
                "notBefore": 1640995200000,
                "notAfter": 1735689600000
              },
              "serialNumber": "2A1B3C4D5E6F"
            },
            "certificateChain": [
              {
                "status": {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                },
                "extraInfo": [
                  {
                    "message": "Assinatura aprovada",
                    "status": "VALID"
                  }
                ],
                "name": "AC BRY SSL",
                "issuer": "Autoridade Certificadora Raiz Brasileira v10",
                "icpBrasil": true,
                "validity": {
                  "notBefore": 1640995200000,
                  "notAfter": 1735689600000
                },
                "serialNumber": "2A1B3C4D5E6F"
              }
            ]
          }
        ],
        "archiveStamps": [
          {
            "status": {
              "message": "Assinatura aprovada",
              "status": "VALID"
            },
            "extraInfo": [
              {
                "message": "Assinatura aprovada",
                "status": "VALID"
              }
            ],
            "date": 1698912385000,
            "hash": {
              "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
              "algorithm": "SHA-256"
            },
            "signatureSuite": "SHA256withRSA",
            "policy": "2.16.76.1.6.6",
            "serialNumber": "123456789",
            "stampCertificate": {
              "status": {
                "message": "Assinatura aprovada",
                "status": "VALID"
              },
              "extraInfo": [
                {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                }
              ],
              "name": "AC BRY SSL",
              "issuer": "Autoridade Certificadora Raiz Brasileira v10",
              "icpBrasil": true,
              "validity": {
                "notBefore": 1640995200000,
                "notAfter": 1735689600000
              },
              "serialNumber": "2A1B3C4D5E6F"
            },
            "certificateChain": [
              {
                "status": {
                  "message": "Assinatura aprovada",
                  "status": "VALID"
                },
                "extraInfo": [
                  {
                    "message": "Assinatura aprovada",
                    "status": "VALID"
                  }
                ],
                "name": "AC BRY SSL",
                "issuer": "Autoridade Certificadora Raiz Brasileira v10",
                "icpBrasil": true,
                "validity": {
                  "notBefore": 1640995200000,
                  "notAfter": 1735689600000
                },
                "serialNumber": "2A1B3C4D5E6F"
              }
            ]
          }
        ],
        "format": "PAdES",
        "filter": "Adobe.PPKLite",
        "subFilter": "ETSI.CAdES.detached",
        "date": 1698912385000,
        "originalHash": {
          "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
          "algorithm": "SHA-256"
        },
        "signatureAlgorithm": "SHA256_WITH_RSA_ENCRYPTION",
        "hashAlgorithm": "SHA256",
        "restrictionType": "NENHUMA_RESTRICAO",
        "icpBrasil": true,
        "fileName": "contrato.pdf",
        "signatureField": "Signature1"
      }
    ],
    "stamps": [
      {
        "status": {
          "message": "Assinatura aprovada",
          "status": "VALID"
        },
        "extraInfo": [
          {
            "message": "Assinatura aprovada",
            "status": "VALID"
          }
        ],
        "date": 1698912385000,
        "hash": {
          "value": "3a7bd3e2360a3d29eea436fcfb7e44c735d117c42d1c1835420b6b9942dd4f1b",
          "algorithm": "SHA-256"
        },
        "signatureSuite": "SHA256withRSA",
        "policy": "2.16.76.1.6.6",
        "serialNumber": "123456789",
        "stampCertificate": {
          "status": {
            "message": "Assinatura aprovada",
            "status": "VALID"
          },
          "extraInfo": [
            {
              "message": "Assinatura aprovada",
              "status": "VALID"
            }
          ],
          "name": "AC BRY SSL",
          "issuer": "Autoridade Certificadora Raiz Brasileira v10",
          "icpBrasil": true,
          "validity": {
            "notBefore": 1640995200000,
            "notAfter": 1735689600000
          },
          "serialNumber": "2A1B3C4D5E6F"
        },
        "certificateChain": [
          {
            "status": {
              "message": "Assinatura aprovada",
              "status": "VALID"
            },
            "extraInfo": [
              {
                "message": "Assinatura aprovada",
                "status": "VALID"
              }
            ],
            "name": "AC BRY SSL",
            "issuer": "Autoridade Certificadora Raiz Brasileira v10",
            "icpBrasil": true,
            "validity": {
              "notBefore": 1640995200000,
              "notAfter": 1735689600000
            },
            "serialNumber": "2A1B3C4D5E6F"
          }
        ]
      }
    ],
    "verifications": [
      {
        "message": "Assinatura aprovada",
        "status": "VALID"
      }
    ]
  }
}