Counts

AI-generated Key Takeaways

• Counts is an abstract entity serving as a base for SummaryCounts and VoteCounts, specifically designed for election results data feeds and not used with pre-election or officeholder feeds.

• SummaryCounts is used to report summary vote counts for contests and geopolitical units, offering insights into metrics like total ballots cast, outstanding, rejected, overvotes, undervotes, and write-ins.

• VoteCounts provides specific vote counts for ballot selections within a contest, incorporating details like geopolitical unit, count type, and the actual vote count, which can be a whole number or a percentage represented as a decimal.

• Counts enables filtering vote counts by device characteristics, ballot types, write-ins, and geopolitical unit association, while also containing elements like GpUnitId, IsSuppressedForPrivacy, Type, and OtherType for detailed reporting.

Note: This entity is only used with election results feeds. It isn't used with the pre-election data or officeholder feed types.

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

• SummaryCounts: Used to report on Contest and geopolitical unit (GpUnit) summary vote counts.
• VoteCounts: Used to report on Contest vote counts.

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.

Note: This entity is only used with election results feeds. It isn't used with the pre-election data or officeholder feed types.

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.

Note: This entity is only used with election results feeds. It isn't used with the pre-election data or officeholder feed types.

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"
      }
    ]