Check pool status

Overview

Query the status of a poll to monitor voting progress, verify completion, and retrieve the outcome.

Endpoint: POST /voting/pool/status/{poolId}

Authentication: Required (Authorization token obtained from the step)

Path Parameters

Parameter	Type	Required	Description
`poolId`	string	Yes	The unique poll identifier returned from create voting

Use Case

Use this endpoint to check the status of a poll created manually or triggered by a policy. The response provides:

Poll State: Current state (active, voting, resolved, expired, failed)

Vote Count: Number of Authenticators that have responded

Quorum Status: Whether minimum required responses have been met

Outcome: Final result if poll is resolved (approved/rejected)

Time Remaining: How much time is left before poll expires

Individual Votes: Which Authenticators voted and their responses (if available)

This is useful for:

Monitoring voting progress in real-time

Verifying if quorum has been met

Determining final poll outcome

Identifying which Authenticators have not responded

Detecting timeout or failure conditions

Correlating poll results with operations

Poll States:

State	Description
Created	Poll created, ballots being distributed
Active	Ballots sent, waiting for responses
Voting	Authenticators are responding
Resolved	Poll completed successfully (approved/rejected)
Expired	Time limit reached before resolution
Failed	Quorum not met or other failure condition

Poll status can only be checked by the profile that created the poll
Status updates in real-time as Authenticators respond
Resolved polls include final outcome (approved/rejected)
Expired polls indicate voting time limit was reached
Failed polls may indicate quorum not met or configuration issues
Use poll ID from create voting response or policy-triggered voting events

application/json

Body

Example

{
    "title": "example_pool_title",
    "question": "example_pool_question",
    "numOfIssuedBallots": 3,
    "numberOfProcessedBallots": 3,
    "status": 1,
    "result": 1
}

Check pool status

Overview