Stay organized with collections
Save and categorize content based on your preferences.
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:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-30 UTC."],[[["\u003cp\u003eThis enumeration is used for pre-election data and election results feed types, specifically within the \u003ccode\u003eCandidate\u003c/code\u003e entity to describe a candidate's ballot status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eCandidate\u003c/code\u003e entity's ballot status has five possible values: \u003ccode\u003eself-declared\u003c/code\u003e, \u003ccode\u003efiled\u003c/code\u003e, \u003ccode\u003equalified\u003c/code\u003e, \u003ccode\u003ewithdrawn\u003c/code\u003e, and \u003ccode\u003ewrite-in\u003c/code\u003e, each providing specific information about the candidate's standing in the election.\u003c/p\u003e\n"],["\u003cp\u003eThe status values reflect a candidate's progression throughout the election timeline, from initial self-declaration to qualification, potential withdrawal, or write-in candidacy.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ewithdrawn\u003c/code\u003e status applies even if the candidate's name still appears on the ballot due to withdrawal after the ballot printing deadline or disqualification for specific reasons.\u003c/p\u003e\n"],["\u003cp\u003eThe table and diagram explain each status value with detailed descriptions and illustrate their application within the election timeline.\u003c/p\u003e\n"]]],[],null,[]]
