Candidate¶
The Candidate object represents a candidate in a contest. If a candidate is running in multiple contests, each contest must have its own Candidate object. Candidate objects may not be reused between Contests.
Tag |
Data Type |
Required? |
Repeats? |
Description |
Error Handling |
---|---|---|---|---|---|
BallotName |
Required |
Single |
The candidate’s name as it will be displayed on the official ballot (e.g. “Ken T. Cuccinelli II”). |
||
ContactInformation |
Optional |
Single |
Contact and physical address information for this Candidate and/or their campaign (see ContactInformation). |
||
ExternalIdentifiers |
Optional |
Single |
Another identifier for a candidate that links to another source of information (e.g. a campaign committee ID that links to a campaign finance system). |
||
FileDate |
|
Optional |
Single |
Date when the candidate filed for the contest. |
|
IsIncumbent |
|
Optional |
Single |
Indicates whether the candidate is the incumbent for the office associated with the contest. |
|
IsTopTicket |
|
Optional |
Single |
Indicates whether the candidate is the top of a ticket that includes multiple candidates. |
|
PartyId |
|
Optional |
Single |
Reference to a Party element with additional information about the candidate’s affiliated party. This is the party affiliation that is intended to be presented as part of ballot information. |
|
PersonId |
|
Optional |
Single |
Reference to a Person element with additional information about the candidate. |
|
PostElectionStatus |
Optional |
Single |
Final status of the candidate (e.g. winner, withdrawn, etc…). |
||
PreElectionStatus |
Optional |
Single |
Registration status of the candidate (e.g. filed, qualified, etc…). |
1<Candidate id="can10961">
2 <BallotName>
3 <Text language="en">Ken T. Cuccinelli II</Text>
4 </BallotName>
5 <PartyId>par0001</PartyId>
6 <PersonId>per10961</PersonId>
7</Candidate>