> [!NOTE]
> **Note:** This enumeration is the same for the pre-election data and election results feed types. It isn't used with officeholder feeds.

The following table lists the enumerations for a candidate's status on the
ballot in the [`Candidate`](https://developers.google.com/civics-data/reference/candidate.md.txt) entity:

| Value | Description |
|---|---|
| `disqualified` | An election authority or court ruled that the candidate can't participate in the contest, such as someone who doesn't live in the right area to be on the ballot. Use this status whether or not they appear on the ballot. |
| `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. |
| `nonqualified-write-in` | A candidate who was self-declared, disqualified or otherwise removed from the primary/general ballot and is pursuing an unverified or non-qualified write-in campaign. |
| `qualified` | The candidate qualifies for the election and will be on the ballot. |
| `qualified-write-in` | A candidate who is officially a registered or qualified write-in (e.g. in states like Illinois where a notarized Declaration of Intent to Be a Write-In Candidate, SBE Form P-1F, is required for votes to be counted). |
| `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. |
| `sub-judice` | The candidate's eligibility for the contest depends on a pending legal or administrative decision, such as a court case or ballot challenge, that could disqualify them. |
| `withdrawn` | The candidate withdrew from the contest. Use this status whether or not they appear on the ballot. |
| `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:

![](https://developers.google.com/static/civics-data/images/status-diagram.png)