Counts

  • The Counts entity is only used with election results feeds and serves as an extension base for SummaryCounts and VoteCounts.

  • Counts allows filtering vote counts by device characteristics, ballot type, write-in type, or linking to a defined geopolitical unit.

  • SummaryCounts provides contest-wide or geopolitical unit-wide summary counts like ballots cast, overvotes, and undervotes.

  • VoteCounts describes the vote counts for BallotSelection within a Contest.

Counts isn't used or referenced directly. Instead, it's only used as an extension base for the following entities:

Counts lets you filter vote counts by device characteristics, or by the type of ballot or write-in. It also lets you link the counts to a defined GpUnit entity, such as for a country.

Elements

The following table describes the elements for Counts:

Element Multiplicity Type Description
GpUnitId 0 or 1 IDREF Unique identifier for a GpUnit element. Used to associate counts with a geopolitical unit, such as a precinct, county, or township.
IsSuppressedForPrivacy 0 or 1 boolean Indicates whether votes are suppressed for voter privacy. If this isn't present, the default value is false.
Type 0 or 1 CountItemType

The type of count being used as a filter on the vote counts, such as election day or early voting.

If the type for a Count item isn't listed in the CountItemType enumeration, set Type to other and include the custom type in OtherType.
OtherType 0 or 1 string Used when Type is other to specify what's being counted.

SummaryCounts

Use SummaryCounts to represent contest-wide or geopolitical unit-wide summary counts.

SummaryCounts includes Counts as an extension base and therefore inherits the elements from Counts. However, SummaryCounts isn't a type of Counts, but is instead included directly for Contest and GpUnit.

SummaryCounts can be used to provide a geographical scope-wide summary of miscellaneous counts associated with a Contest, such as the total number of ballots cast, total number of overvotes, undervotes, and write-ins. SummaryCounts can optionally reference GpUnit elements defined for lower-level reporting units. This lets you associate summary counts with other lower-level reporting units within the scope of the contest.

SummaryCounts can also be used to provide summary counts specific to a GpUnit. For example, a GpUnit defined for a country can include SummaryCounts to provide a summary count. SummaryCounts, in this case, doesn't include the GpUnitId element in Counts.

In Counts, if the type of count item isn't listed in the enumeration CountItemType, use other and include the custom type in OtherType.

Elements

The following table describes the elements for SummaryCounts:

Element Multiplicity Type Description
BallotsCast 0 or 1 integer Number of ballots cast.
BallotsOutstanding 0 or 1 integer Number of ballots not yet counted.
BallotsRejected 0 or 1 integer Number of ballots rejected.
Overvotes 0 or 1 integer Number of overvotes.
Undervotes 0 or 1 integer Number of undervotes.
WriteIns 0 or 1 integer Number of write-ins.

Examples

XML

    <SummaryCounts>
      <BallotsCast>2089540</BallotsCast>
      <WriteIns>2087</WriteIns>
    </SummaryCounts>

JSON

    "SummaryCounts": [
      {
        "BallotsCast": "2089540",
        "WriteIns": "2087"
      }
    ]

VoteCounts

Use VoteCounts to describe the vote counts for BallotSelection in a Contest.

Elements

The following table describes the elements for VoteCounts:

Element Multiplicity Type Description
Count 0 or 1 float

The count of contest votes cast, as a number between 0 and 100. In special cases, the count can include a fractional component. For example, report 14.2% as 14.2 and not 0.142.

For a list of supported types of vote counts, see Result tabulation types.

Examples

XML

    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>total</Type>
      <Count>6173433</Count>
    </VoteCounts>
    <VoteCounts>
      <GpUnitId>ru_001</GpUnitId>
      <Type>other</Type>
      <OtherType>projected-vote-percent</OtherType>
      <Count>22.3</Count>
    </VoteCounts>

JSON

    "VoteCounts": [
      {
        "GpUnitId": "ru_001",
        "Type": "total",
        "Count": "6173433"
      },
      {
        "GpUnitId": "ru_001",
        "Type": "other",
        "OtherType": "projected-vote-percent",
        "Count": "22.3"
      }
    ]