PartyContest

An extension of ContestBase which describes a contest in which the possible ballot selections are of type PartySelection. These could include contests in which straight-party selections are allowed, or party-list contests (although these are more common outside of the United States).

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. If the field is invalid or not present, then the implementation should ignore it.
BallotSelectionIds xs:IDREFS Optional Single References a set of BallotSelections, which could be of any selection type that extends BallotSelectionBase. If the field is invalid or not present, then the implementation should ignore it.
BallotSubTitle InternationalizedText Optional Single Subtitle of the contest as it appears on the ballot. If the element is invalid or not present, then the implementation should ignore it.
BallotTitle InternationalizedText Optional Single Title of the contest as it appears on the ballot. If the element is invalid or not present, then the implementation should ignore it.
ElectoralDistrictId xs:IDREF Required Single References an ElectoralDistrict element that represents the geographical scope of the contest. If the field is invalid, then the implementation should ignore it.
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. If the element is invalid or not present, then the implementation should ignore it.
ExternalIdentifiers ExternalIdentifiers Optional Single Other identifiers for a contest that links to another source of information. If the element is invalid or not present, then the implementation should ignore it.
HasRotation xs:boolean Optional Single Indicates whether the selections in the contest are rotated. If the field is invalid or not present, then the implementation should ignore it.
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). If the field is invalid, then the implementation should ignore it.
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. If the field is invalid or not present, then the implementation should ignore it.
VoteVariation VoteVariation Optional Single Vote variation associated with the contest (e.g. n-of-m, majority, et al). If the field is invalid or not present, then the implementation should ignore it.
OtherVoteVariation xs:string Optional Single If “other” is selected as the VoteVariation, the name of the variation can be specified here. If the field is invalid or not present, then the implementation should ignore it.