Contest

Use this data entity for describing a contest and linking the contest to the associated candidates and parties.

Contest is an abstract element with two types that get used according to the type of contest:

  • CandidateContest: Used for a contest involving one or more candidates for an office
  • PartyContest: Used for a contest for a party list selection on the ballot

Each type is used to include information for that specified type of contest, for example, CandidateContest is used to include information about a candidate contest including the associated office and the number of candidates that can be voted for.

Contest references BallotSelection to link the selections on the ballot to the contest. The order of candidates or parties in Contest should be the same as the elements in BallotSelection.

Contest references a required ElectoralDistrictId reference to a GpUnit defined for the geographical scope of the contest. For example, for a specific contest, ElectoralDistrictId would reference a ReportingUnit defined for the district associated with the contest. Office also includes an optional reference that serves the same purpose. For example, for a national contest, the same GpUnit defined for the country can be reused.

Contest includes SummaryCounts for providing a summary of miscellaneous counts associated with the contest, including total number of ballots cast containing the contest, total number of abstentions, overvotes, undervotes, or write-ins. The summary counts can be associated with the contest as a whole, or with other lower-level reporting units by using multiple occurrences of SummaryCounts.

SequenceOrder is used for results display ordering. For example, "100" may indicate a regional contest, "200" may indicate a local contest, and so on. SequenceOrder is not appropriate to use as the contest order on the ballot; contest order on each ballot can be preserved, however, using the BallotStyle entity, which associates ballot styles with their corresponding geopolitical units.

When including ExternalIdentifiers, if the type is not listed in enumeration IdentifierType, use other and include the type (that is not listed in the enumeration) in OtherType.

The table below describes the attributes for Contest:

Attribute Required? Type Description
objectId required ID Unique internal identifier used by other elements to reference this element.

The table below describes the elements for Contest:

Element Multiplicity Type Description
Abbreviation 0 or 1 string Abbreviation for the contest.
BallotSelection 0 or more BallotSelection For associating a ballot selection for the contest, i.e., a candidate, a ballot measure.
BallotSubTitle 0 or 1 InternationalizedText Subtitle of the contest as it appears on the ballot.
BallotTitle 0 or 1 InternationalizedText Title of the contest as it appears on the ballot.
CountStatus 0 or more CountStatus For providing various counting status associated with the contest.
ElectoralDistrictId 1 IDREF Unique identifier for a GpUnit element. For associating the contest with a reporting unit that represents the geographical scope of the contest, for example, a district, etc.
ExternalIdentifiers 0 or 1 ExternalIdentifiers For associating an ID with the contest.
HasRotation 0 or 1 boolean Boolean to indicate whether the selections in the contest are rotated. Assumed to be "no" if not present.
Name 1 string Name of the contest, not necessarily as it appears on the ballot.
SequenceOrder 0 or 1 integer Orderering for listing the contest for purposes of results display. If not present, no order is assumed.
SubUnitsReported 0 or 1 integer Number of subunits, for example, constituencies that have completed reporting votes for this contest.
SummaryCounts 0 or more SummaryCounts For providing a summary of miscellaneous counts associated with the contest.
TotalSubUnits 0 or 1 integer Total number of subunits, for example, constituencies that have this contest on the ballot.
VoteVariation 0 or 1 VoteVariation Vote variation associated with the contest, for example, n-of-m.
OtherVoteVariation 0 or 1 string For use when VoteVariation is other.

CandidateContest

Use this entity to describe a contest that involves selecting one or more candidates.

This entity may optionally reference Office or Party by ID. If the candidate contest is associated with a ticket (of candidates) and each candidate in the ticket is associated with a separate office, OfficeIds can contain reference to each of the separate offices. For example, if the contest is for the state governor ticket but Governor and Lieutenant (Lt.) Governor are both separate offices, OfficeIds will contain a reference first to the Office element defined for the Governor's office and then to the Lt. Governor's office.

The table below describes the elements for CandidateContest:

Element Multiplicity Type Description
NumberElected 0 or 1 integer Number of candidates that are elected in the contest ("n" of n-of-m).
OfficeIds 0 or 1 IDREFS Unique identifier for one or more Office elements. For associating office descriptions.
PrimaryPartyIds 0 or 1 IDREFS Unique identifier for one or more Party elements, indicating that the Contest is part of a partisan primary.
VotesAllowed 1 integer Maximum number of votes/write-ins per voter in this contest.

Examples

The following contest examples are for two offices: (a) President and (b) Vice President. Therefore, it links to two offices and each BallotSelection has two candidates.

XML

    <Contest objectId="cc20002" xsi:type="CandidateContest">
      <BallotSelection objectId="cs10861" xsi:type="CandidateSelection">
        <CandidateIds>can10861a can10861b</CandidateIds>
      </BallotSelection>
      <BallotSelection objectId="cs10862" xsi:type="CandidateSelection">
        <CandidateIds>can10862a can10862b</CandidateIds>
      </BallotSelection>
      <BallotTitle>
        <Text language="en">President and Vice-President</Text>
        <Text language="id">Presiden dan Wakil Presiden</Text>
        <Text language="es">Presidente y Vicepresidente</Text>
        <Text language="hi">राष्ट्रपति और उपराष्ट्रपति</Text>
      </BallotTitle>
      <ElectoralDistrictId>ru0002</ElectoralDistrictId>
      <Name>President and Vice-President</Name>
      <NumberElected>1</NumberElected>
      <OfficeIds>off9999a off9999b</OfficeIds>
      <VotesAllowed>1</VotesAllowed>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "CandidateContest",
        "objectId": "cc20002",
        "BallotSelection": [
          {
            "@type": "CandidateSelection",
            "objectId": "cs10861",
            "CandidateIds": [
              "can10861a", "can10861b"
            ]
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs10862",
            "CandidateIds": [
              "can10862a", "can10862b"
            ]
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "President and Vice-President",
              "language": "en"
            },
            {
              "value": "Presiden dan Wakil Presiden",
              "language": "id"
            },
            {
              "value": "Presidente y Vicepresidente",
              "language": "es"
            },
            {
              "value": "राष्ट्रपति और उपराष्ट्रपति",
              "language": "hi"
            }
          ]
        },
        "ElectoralDistrictId": "ru0002",
        "Name": "President and Vice-President",
        "NumberElected": 1,
        "OfficeIds": [
          "off9999a",
          "off9999b"
        ],
        "VotesAllowed": 1
      }
    ]

PartyContest

Use this entity for a contest that involves choosing a party on the ballot. PartyContest has the same elements as Contest. The only difference is the BallotSelection elements must be of type PartySelection.

The table below describes the elements for PartyContest:

Element Multiplicity Type Description
TotalSubUnits 0 or 1 integer Total number of associated subunits such as precincts.
VoteVariation 0 or more VoteVariationType Number of vote variations for the contest.
NumberElected 0 or 1 integer Number of candidates that are elected in the contest ("n" of n-of-m).
VotesAllowed 1 integer Maximum number of votes/write-ins per voter in this contest.

Examples

Party Contest

XML

    <Contest objectId="pc20001" xsi:type="PartyContest">
      <BallotSelection objectId="ps10132" xsi:type="PartySelection">
        <PartyIds>par10132 par10133</PartyIds>
      </BallotSelection>
      <BallotTitle>
        <Text language="en">Constituency-level seat</Text>
      </BallotTitle>
      <Name>Constituency-level seat</Name>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "PartyContest",
        "objectId": "pc20001",
        "BallotSelection": [
          {
            "@type": "PartySelection",
            "objectId": "ps10132",
            "PartyIds": [
              "par10132", "par10133"
            ]
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "Constituency-level seat",
              "language": "en"
            }
          ]
        },
        "Name": "Constituency-level seat"
      }
    ]

Candidate Contest

XML

    <Contest xsi:type="CandidateContest" objectId="cc1-001">
      <Abbreviation>KENYAPRES</Abbreviation>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenyatta">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-odinga">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-mudavadi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kenneth">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-dida">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-karua">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-kiyiapi">...</BallotSelection>
      <BallotSelection xsi:type="CandidateSelection" objectId="cs1-001-muite">...</BallotSelection>
      <BallotTitle>
        <Text language="en">President and Vice-President of Kenya</Text>
        <Text language="es">Presidente y Vice-Presidente de Kenya</Text>
        <Text language="fr">Président et vice-président du Kenya</Text>
        <Text language="id">Presiden dan Wakil Presiden Kenya</Text>
        <Text language="hi">राष्ट्रपति और केन्या के उपराष्ट्रपति</Text>
        <Text language="sw">Rais na Makamu wa Rais of Kenya</Text>
      </BallotTitle>
      <CountStatus>...</CountStatus>
      <ElectoralDistrictId>...</ElectoralDistrictId>
      <Name>President of Kenya</Name>
      <SubUnitsReported>48</SubUnitsReported>
      <SummaryCounts>...</SummaryCounts>
      <TotalSubUnits>48</TotalSubUnits>
      <VoteVariation>1-of-m</VoteVariation>
      <NumberElected>1</NumberElected>
      <VotesAllowed>1</VotesAllowed>
    </Contest>

JSON

    "Contest": [
      {
        "@type": "CandidateContest",
        "objectId": "cc1-001",
        "Abbreviation": "KENYAPRES",
        "BallotSelection": [
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenyatta",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-odinga",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-mudavadi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kenneth",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-dida",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-karua",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-kiyiapi",
            ...
          },
          {
            "@type": "CandidateSelection",
            "objectId": "cs1-001-muite",
            ...
          }
        ],
        "BallotTitle": {
          "Text": [
            {
              "value": "President and Vice-President of Kenya",
              "language": "en"
            },
            {
              "value": "Presidente y Vice-Presidente de Kenya",
              "language": "es"
            },
            {
              "value": "Président et vice-président du Kenya",
              "language": "fr"
            },
            {
              "value": "Presiden dan Wakil Presiden Kenya",
              "language": "id"
            },
            {
              "value": "राष्ट्रपति और केन्या के उपराष्ट्रपति",
              "language": "hi"
            },
            {
              "value": "Rais na Makamu wa Rais of Kenya",
              "language": "sw"
            }
          ]
        },
        "CountStatus": "...",
        "ElectoralDistrictId": "...",
        "Name": "President of Kenya",
        "SubUnitsReported": 48,
        "SummaryCounts": "...",
        "TotalSubUnits": 48,
        "VoteVariation": "1-of-m",
        "NumberElected": 1,
        "VotesAllowed": 1
      }
    ]