CandidatePostElectionStatus

Page Summary

• Election result feeds use specific enumerations for candidate status.

• Statuses include advanced-to-runoff, projected-winner, winner, and withdrawn.

• These enumerations are not used for pre-election data or officeholder feeds.

Note: This enumeration is only used with election results feeds. It isn't used with the pre-election data or officeholder feed types.

The following table lists the enumerations for the status of the election results in the Candidate entity:

Value	Description
advanced-to-runoff	The candidate is one of the top N candidates in a contest who will advance to the next round of voting.
defeated	The candidate participated in the contest and lost.
did-not-participate	The candidate didn't take part in the contest, such as someone who filed or declared but never appeared on the ballot or had a write-in campaign.
disqualified	An election authority or court ruled that the candidate can't participate in the contest or invalidated their candidacy after voting took place.
projected-advanced-to-runoff	The candidate is expected to be one of the top N candidates in a contest who will advance to the next round of voting, but the official results aren't yet complete.
projected-winner	The candidate is expected to win, but the official results aren't yet complete.
sub-judice	The candidate's final status depends on a pending legal or administrative decision, such as a court challenge to the outcome.
winner	The candidate has officially won.
withdrawn	The candidate has withdrawn from the contest. withdrawn is deprecated. Use a more specific status instead, such as defeated, did-not-participate, or disqualified.