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 |
|---|---|---|---|---|---|
| ballot_name | xs:string |
Required | Single | The candidate’s name as it will be displayed on the official ballot (e.g. “Ken T. Cuccinelli II”). | If the element is invalid, then the
implementation is required to ignore the
Candidate element containing it. |
| contact_information | xs:string |
Optional | Single | Contact and physical address information for this Candidate and/or their campaign (see contact_information). | If the element is invalid or not present, then the implementation is required to ignore it. |
| external_identifiers | external_identifiers | 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). | If the element is invalid or not present, then the implementation is required to ignore it. |
| file_date | xs:date |
Optional | Single | Date when the candidate filed for the contest. | If the field is invalid or not present, then the implementation is required to ignore it. |
| is_incumbent | xs:boolean |
Optional | Single | Indicates whether the candidate is the incumbent for the office associated with the contest. | If the field is invalid or not present, then the implementation is required to ignore it. |
| is_top_ticket | xs:boolean |
Optional | Single | Indicates whether the candidate is the top of a ticket that includes multiple candidates. | If the field is invalid or not present, then the implementation is required to ignore it. |
| party_id | xs:IDREF |
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. | If the field is invalid or not present, then the implementation is required to ignore it. |
| person_id | xs:IDREF |
Optional | Single | Reference to a person element with additional information about the candidate. | If the field is invalid or not present, then the implementation is required to ignore it. |
| post_election_status | candidate_post_election_status | Optional | Single | Final status of the candidate (e.g. winner, withdrawn, etc…). | If the field is invalid or not present, then the implementation is required to ignore it. |
| pre_election_status | candidate_pre_election_status | Optional | Single | Registration status of the candidate (e.g. filed, qualified, etc…). | If the field is invalid or not present, then the implementation is required to ignore it. |
1 2 3 4 5 | id,ballot_name,external_identifier_type,external_identifier_othertype,external_identifier_value,file_date,is_incumbent,is_top_ticket,party_id,person_id,post_election_status,pre_election_status
can001,Jude Fawley,,,,2016-12-01,true,false,par01,per50001,,filed
can002,Arabella Donn,,,,2016-12-01,false,false,par02,per50002,,qualified
can003,John Coltrane,,,,2016-09-23,false,false,par02,per50003,,qualified
can004,Miles Davis,,,,2016-05-26,false,false,par01,per50004,,qualified
|