Retrieve Sign & Seal Verification results

On this page, you will learn how to retrieve detailed information about a processed Sign & Seal Verification.

Get Sign & Seal Verification results via Webhooks

Webhooks provide an efficient way to get notified when a Sign & Seal Verification has been completed, and to retrieve the related verification results. For more details on setting up and managing Webhooks, please refer to this dedicated section.

To receive those notifications, subscribe to the following event:

EventDescription
verification.signature_seal.doneTriggered when a Sign & Seal Verification is complete

Example Webhook payload for a verified Sign & Seal Verification:

{
  "event_id": "57ec86c3-23b4-4720-aaf6-535e46347a94",
  "event_name": "verification.signature_seal.done",
  "event_time": "1348177752",
  "subscription_id": "d09f0367-d80a-309c-a2ed-7083991fc564",
  "subscription_description": "A great webhook",
  "sandbox": false,
  "data": {
    "signature_seal": {
      "id": "1f3a8e7a-3948-4680-b306-75cd1b49e761",
      "workspace_id": "9b2c4d1e-6f70-4a8b-9c0d-1e2f3a4b5c6d",
      "status": "verified",
      "status_codes": [],
      "created_at": "2026-10-02T09:11:48+00:00",
      "updated_at": "2026-10-02T09:11:53+00:00",
      "document_name": "contract-2026.pdf",
      "data_anonymized": false,
      "signatures": [
        {
          "id": "Signature1",
          "type": "signature",
          "status": "verified",
          "level": "qes",
          "certificate": {
            "common_name": "Thomas Dupont",
            "organisation": null,
            "country_code": "FR"
          },
          "signed_at": "2026-06-21T12:31:22+00:00",
          "reason": "Signed by Thomas Dupont",
          "trust_source": "eu_eidas",
          "checks": [
            { "name": "integrity", "status": "verified" },
            { "name": "certificate_validity", "status": "verified" },
            { "name": "trusted_provider", "status": "verified" }
          ]
        }
      ]
    }
  }
}

For more information on the statuses and status codes, refer to this section.

Retrieve detailed Sign & Seal Verification results

You can also obtain detailed verification results by calling a dedicated endpoint, with the id returned when requesting a Sign & Seal Verification:

GET /verifications/signatures_seals/{id}

Example for a document with a qualified signature and a seal from a provider outside the EU trusted lists:

{
  "id": "1f3a8e7a-3948-4680-b306-75cd1b49e761",
  "workspace_id": "9b2c4d1e-6f70-4a8b-9c0d-1e2f3a4b5c6d",
  "status": "inconclusive",
  "status_codes": ["SSV_1301"],
  "created_at": "2026-10-02T09:11:48+00:00",
  "updated_at": "2026-10-02T09:11:53+00:00",
  "document_name": "contract-2026.pdf",
  "data_anonymized": false,
  "signatures": [
    {
      "id": "Signature1",
      "type": "signature",
      "status": "verified",
      "level": "qes",
      "certificate": {
        "common_name": "Thomas Dupont",
        "organisation": null,
        "country_code": "FR"
      },
      "signed_at": "2026-06-21T12:31:22+00:00",
      "reason": "Signed by Thomas Dupont",
      "trust_source": "eu_eidas",
      "checks": [
        { "name": "integrity", "status": "verified" },
        { "name": "certificate_validity", "status": "verified" },
        { "name": "trusted_provider", "status": "verified" }
      ]
    },
    {
      "id": "Signature2",
      "type": "seal",
      "status": "inconclusive",
      "level": "not_qualified",
      "certificate": {
        "common_name": "Example Trust Services",
        "organisation": "Example Trust Services Inc.",
        "country_code": "US"
      },
      "signed_at": "2026-06-21T12:32:05+00:00",
      "reason": null,
      "trust_source": null,
      "checks": [
        { "name": "integrity", "status": "verified" },
        { "name": "certificate_validity", "status": "verified" },
        { "name": "trusted_provider", "status": "inconclusive" }
      ]
    }
  ]
}

Similar to the webhook, you will receive the verification status and any associated status codes if the verification was inconclusive or failed. For more information on the statuses and status codes, refer to this section.

This endpoint also returns additional information about each signature or seal found in the document:

  • Checks: the result of the integrity, certificate_validity and trusted_provider checks.
  • Type: signature, seal, or unknown when it cannot be determined.
  • Certificate: the common name, organisation and country of the certificate holder.
  • Level: qes when the signature or seal is qualified, otherwise not_qualified or unknown.
  • Signing time: the time declared by the signer, which is not proven.
  • Reason: the reason declared in the signature, if any. Free text, not verified.
  • Trust source: eu_eidas when the provider is on the EU trusted lists.

7 days after the analysis is completed, Sign & Seal Verification records are anonymized, meaning the names of the signers and sealing entities, and the declared reasons, are permanently deleted.

If you attempt to retrieve any verification details beyond this retention period, fields containing sensitive data will return null, and the data_anonymized parameter will be set to true:

{
  "id": "1f3a8e7a-3948-4680-b306-75cd1b49e761",
  "workspace_id": "9b2c4d1e-6f70-4a8b-9c0d-1e2f3a4b5c6d",
  "status": "verified",
  "status_codes": [],
  "created_at": "2026-10-02T09:11:48+00:00",
  "updated_at": "2026-10-09T09:11:53+00:00",
  "document_name": "contract-2026.pdf",
  "data_anonymized": true,
  "signatures": [
    {
      "id": "Signature1",
      "type": "signature",
      "status": "verified",
      "level": "qes",
      "certificate": {
        "common_name": null,
        "organisation": null,
        "country_code": "FR"
      },
      "signed_at": "2026-06-21T12:31:22+00:00",
      "reason": null,
      "trust_source": "eu_eidas",
      "checks": [
        { "name": "integrity", "status": "verified" },
        { "name": "certificate_validity", "status": "verified" },
        { "name": "trusted_provider", "status": "verified" }
      ]
    }
  ]
}

List all Sign & Seal Verification requests

To retrieve a list of all verification requests, you can call the following endpoint. You can filter by status, workspace or creation date, or paginate the results based on your needs:

GET /verifications/signatures_seals

{
  "meta": {
    "next_cursor": "string"
  },
  "data": [
    {
      "id": "1f3a8e7a-3948-4680-b306-75cd1b49e761",
      "workspace_id": "9b2c4d1e-6f70-4a8b-9c0d-1e2f3a4b5c6d",
      "status": "inconclusive",
      "status_codes": ["SSV_1301"],
      "created_at": "2026-10-02T09:11:48+00:00",
      "updated_at": "2026-10-02T09:11:53+00:00"
    }
  ]
}