Skip to main content
GET
Check Consensus
Returns the current consensus state for a witness request, including vote tallies and final determination. Use this endpoint to poll for consensus completion or to retrieve the final result after witnesses have attested. Consensus is computed automatically when the number of attestations reaches the required_witnesses threshold. A simple majority of confirm or deny verdicts determines the outcome. abstain votes count toward the quorum but do not influence the majority calculation.

Authentication

Requires X-API-Key header or Bearer JWT token. The workspace is derived from the authenticated credential; do not send X-Tenant-ID.

Response

string
The witness request identifier.
string
The truth claim that was being witnessed.
string
Current status of the witness request. One of: - pending — still awaiting attestations - confirmed — consensus reached, claim is confirmed - denied — consensus reached, claim is denied - expired — TTL elapsed without reaching quorum
integer
Number of attestations required for consensus.
integer
Number of confirm verdicts received.
integer
Number of deny verdicts received.
integer
Number of abstain verdicts received.
boolean
Whether the required quorum has been met and a determination made.
string
ISO 8601 timestamp of when consensus was reached. null if still pending or expired without consensus.
string
ISO 8601 timestamp of when the witness request expires (or expired).

Consensus Logic

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

witnessRequestID
string<uuid>
required

Witness group identifier

Response

Consensus status

reached
boolean
attestation_count
integer
required
integer
signatures
string[]