Get Witness Consensus

Retrieve the consensus result for a witness verification request

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

id · string · required

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

Response

id · string

The witness request identifier.

claim_id · string

The truth claim that was being witnessed.

status · 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

required_witnesses · integer

Number of attestations required for consensus.

confirmations · integer

Number of confirm verdicts received.

denials · integer

Number of deny verdicts received.

abstentions · integer

Number of abstain verdicts received.

consensus_reached · boolean

Whether the required quorum has been met and a determination made.

consensus_at · string

ISO 8601 timestamp of when consensus was reached. null if still pending or expired without consensus.

expires_at · string

ISO 8601 timestamp of when the witness request expires (or expired).

Consensus Logic

Scenario	Outcome
Quorum met, majority confirm	confirmed
Quorum met, majority deny	denied
Quorum met, equal confirm/deny	Weighted by confidence scores; highest aggregate confidence wins
TTL expires before quorum	expired