CandidateContest

CandidateContest extends ContestBase and represents a contest among candidates.

Tag	Data Type	Required?	Repeats?	Description	Error Handling
NumberElected	xs:integer	Optional	Single	Number of candidates that are elected in the contest (i.e. “N” of N-of-M).
OfficeIds	xs:IDREFS	Optional	Single	References a set of Office elements, if available, which give additional information about the offices. Note: the order of the office IDs must be in the same order as the candidates listed in BallotSelectionIds. E.g., if the various BallotSelectionIds reference CandidateSelection elements which reference the candidate for President first and Vice-President second, the OfficeIds should reference the office of President first and the office of Vice-President second.
PrimaryPartyIds	xs:IDREFS	Optional	Single	References Party elements, if the contest is related to a particular party.
VotesAllowed	xs:integer	Optional	Single	Maximum number of votes/write-ins per voter in this contest.

<CandidateContest id="cc20003">
   <BallotSelectionIds>cs10961 cs10962 cs10963</BallotSelectionIds>
   <BallotTitle>
     <Text language="en">Governor of Virginia</Text>
   </BallotTitle>
   <ElectoralDistrictId>ed60129</ElectoralDistrictId>
   <Name>Governor</Name>
   <NumberElected>1</NumberElected>
   <OfficeId>off0000</OfficeId>
   <VotesAllowed>1</VotesAllowed>
</CandidateContest>

ContestBase

A base model for all Contest types: BallotMeasureContest, CandidateContest, PartyContest, and RetentionContest (NB: the latter because it extends BallotMeasureContest).

Tag	Data Type	Required?	Repeats?	Description	Error Handling
Abbreviation	xs:string	Optional	Single	An abbreviation for the contest.
BallotSelectionIds	xs:IDREFS	Optional	Single	References a set of BallotSelections, which could be of any selection type that extends BallotSelectionBase.
BallotSubTitle	InternationalizedText	Optional	Single	Subtitle of the contest as it appears on the ballot.
BallotTitle	InternationalizedText	Optional	Single	Title of the contest as it appears on the ballot.
ElectoralDistrictId	xs:IDREF	Required	Single	References an ElectoralDistrict element that represents the geographical scope of the contest.
ElectorateSpecification	InternationalizedText	Optional	Single	Specifies any changes to the eligible electorate for this contest past the usual, “all registered voters” electorate. This subtag will most often be used for primaries and local elections. In primaries, voters may have to be registered as a specific party to vote, or there may be special rules for which ballot a voter can pull. In some local elections, non-citizens can vote.
ExternalIdentifiers	ExternalIdentifiers	Optional	Single	Other identifiers for a contest that links to another source of information.
HasRotation	xs:boolean	Optional	Single	Indicates whether the selections in the contest are rotated.
Name	xs:string	Required	Single	Name of the contest, not necessarily how it appears on the ballot (NB: BallotTitle should be used for this purpose).
SequenceOrder	xs:integer	Optional	Single	Order in which the contests are listed on the ballot. This is the default ordering, and can be overrides by data in a BallotStyle element.
VoteVariation	VoteVariation	Optional	Single	Vote variation associated with the contest (e.g. n-of-m, majority, et al).
OtherVoteVariation	xs:string	Optional	Single	If “other” is selected as the VoteVariation, the name of the variation can be specified here.