> [!NOTE]
> **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`](https://developers.google.com/civics-data/reference/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. > [!WARNING] > `withdrawn` is deprecated. Use a more specific status instead, such as `defeated`, `did-not-participate`, or `disqualified`. |