Skip to main content
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. Tenant-scoped via X-Tenant-ID.

​
Path Parameters

​
string
required
The unique identifier of the witness request. Format: maip-wit:ULID.

​
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