Election Table

GET /tables/election?args

List full details about past and current elections. Elections represent metadata about each consecutive run of related voting periods. Elections may contain 4, 2 or 1 vote periods. They are called empty when only one empty proposal vote without a proposal exists.

Schema

Field	Description
row_id uint64	Unique row identifier.
proposal_id uint64	Unique row_id of the winning proposal, if any.
num_periods int64	Election duration in number of voting periods.
num_proposals int64	Total number of submitted proposals.
voting_perid int64	On-chain voting period number.
start_time datetime	Block time of election start block.
end_time datetime	Block time of election end block.
start_height int64	Block height of election start block.
end_height int64	Block height of election end block.
is_empty bool	Flag indicating no proposal was submitted.
is_open bool	Flag indicating the election is in progress.
is_failed bool	Flag indicating the election has failed to select or activate a new protocol.
no_quorum bool	Flag indicating the election has failed because no quorum could be reached.
no_majority bool	Flag indicating the election has failed because no majority could be reached.
proposal hash	Hash of the proposal that is voted on, if any.
last_voting_period enum	Type of the last period at which this election ended proposal, exploration, cooldown, promotion, adoption.

Response

[
  [
    13,              // row_id
    5,               // proposal_id
    4,               // num_periods
    2,               // num_proposals
    15,              // voting_perid
    1563303754000,   // start_time
    0,               // end_time
    524288,          // start_height
    0,               // end_height
    0,               // is_empty
    1,               // is_open
    0,               // is_failed
    0,               // no_quorum
    0,               // no_majority
    "PsBABY5HQTSkA4297zNHfsZNKtxULfL18y95qb3m53QJiXGmrbU", // proposal
    "promotion_vote" // last_voting_period
  ]
]

Example

curl "https://api.tzpro.io/tables/election?proposal=PsBABY5HQTSkA4297zNHfsZNKtxULfL18y95qb3m53QJiXGmrbU"