Evidence

SignumEra signing requests produce evidence associated with the signing ceremony and signed document.

The current API exposes evidence readiness through the signing request status endpoint.

GET /api/v1/signing-requests/{id}

Required Scope

signing.read

Evidence Status

The response contains an evidence.ready field.

{
    "id": "REQUEST_ID",
    "status": "completed",

    "document": {
        "status": "finalized"
    },

    "evidence": {
        "ready": true
    },

    "finalized_at": "2026-10-03T19:30:00Z"
}

Value	Meaning
`false`	The final evidence package is not yet available.
`true`	SignumEra reports that evidence for the signing request is ready.

Evidence-package retrieval is not currently exposed through the public v1 Laravel API. A future evidence retrieval endpoint will require the evidence.read OAuth scope.

Polling for Completion

Applications may query the signing-request status endpoint until the signing request is finalized and evidence.ready becomes true.

curl \
  "https://api.signumera.com/api/v1/signing-requests/REQUEST_ID" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Evidence Scope

SignumEra defines the OAuth scope:

evidence.read

This scope is reserved for retrieval of evidence-package metadata and authorized evidence when the public evidence retrieval API is enabled.