party_contest

An extension of contest_base which describes a contest in which the possible ballot selections are of type party_selection. 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).

id,abbreviation,ballot_selection_ids,ballot_sub_title,ballot_title,electoral_district_id,electorate_specification,external_identifier_type,external_identifier_othertype,external_identifier_value,has_rotation,name,sequence_order,vote_variation,other_vote_variation
pcon001,PC1071,bs001 bs002,,Party Election,ed001,all registered voters,,,,false,Straight Party Vote,3,,

contest_base

A base model for all Contest types: ballot_measure_contest, candidate_contest, party_contest, and retention_contest (NB: the latter because it extends ballot_measure_contest).

Tag	Data Type	Required?	Repeats?	Description	Error Handling
abbreviation	xs:string	Optional	Single	An abbreviation for the contest.
ballot_selection_ids	xs:IDREFS	Optional	Single	References a set of BallotSelections, which could be of any selection type that extends ballot_selection_base.
ballot_sub_title	xs:string	Optional	Single	Subtitle of the contest as it appears on the ballot.
ballot_title	xs:string	Optional	Single	Title of the contest as it appears on the ballot.
electoral_district_id	xs:IDREF	Required	Single	References an electoral_district element that represents the geographical scope of the contest.
electorate_specification	xs:string	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.
external_identifiers	xs:string	Optional	Single	Other identifiers for a contest that links to another source of information.
has_rotation	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).
sequence_order	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 ballot_style element.
vote_variation	vote_variation	Optional	Single	Vote variation associated with the contest (e.g. n-of-m, majority, et al).
other_vote_variation	other_vote_variation	Optional	Single	If “other” is selected as the VoteVariation, the name of the variation can be specified here.