CandidatePreElectionStatus

  • The provided enumerations for candidate status are applicable to pre-election data and election results feeds, but not officeholder feeds.

  • The table lists five possible candidate statuses: self-declared, filed, qualified, withdrawn, and write-in.

  • Each status has a specific description explaining its meaning and when it is typically used.

  • A diagram illustrates the timeline during which each candidate status is applicable.

The following table lists the enumerations for a candidate's status on the ballot in the Candidate entity:

Value Description
self-declared A self-declared candidate for whom there's no confirmation about whether they filed or are qualified for the ballot. For example, if they don't have an Election Commission ID.
filed There's confirmation that the candidate has filed to be on the ballot, such as an FEC ID number or state ID. Use this status until the filing deadline passes.
qualified The candidate qualifies for the election and will be on the ballot.
withdrawn

The candidate withdrew from the contest. Use this status whether or not they appear on the ballot.

Includes actual, non-vandalistic people who withdrew or were disqualified, such as people who don't live in the right area to be on the ballot or those who have pending legal action that disallows participation.

write-in Someone who didn't qualify for the ballot but who is a candidate.

The following diagram identifies where in the timeline each status is applicable: