Stay organized with collections
Save and categorize content based on your preferences.
This enumeration is for the items that are counted during the course of an
election and for which the status of the counts are of interest. Used in the
Counts and
CountStatus elements.
The following table describes the values for CountItemType:
Value
Description
absentee
For general absentee ballots without a more specific type.
absentee-in-person
For absentee ballots that are cast in-person, such as at a city
office.
absentee-mail
For absentee ballots submitted by postal mail.
early
For ballots cast during early voting periods.
election-day
For ballots cast on election day.
provisional
For challenged ballots.
total
For the total of all ballot types.
write-in
For write-ins on ballots.
other
The count is a type that isn't included in this enumeration. If used,
provide the item's custom type in an OtherType
element.
Result tabulation types
The following table lists enumerations for the election results reported by
VoteCounts.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-21 UTC."],[[["\u003cp\u003eThis documentation details the \u003ccode\u003eCountItemType\u003c/code\u003e enumeration used exclusively for election results feeds within the Google Civic Information API.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eCountItemType\u003c/code\u003e values categorize ballot types (e.g., absentee, election-day, provisional) and are used within \u003ccode\u003eCounts\u003c/code\u003e and \u003ccode\u003eCountStatus\u003c/code\u003e elements.\u003c/p\u003e\n"],["\u003cp\u003eResult tabulation types, such as \u003ccode\u003etotal\u003c/code\u003e, \u003ccode\u003etotal-percent\u003c/code\u003e, and various seat-related types, are reported by \u003ccode\u003eVoteCounts\u003c/code\u003e and use specific \u003ccode\u003eType\u003c/code\u003e or \u003ccode\u003eOtherType\u003c/code\u003e values for identification.\u003c/p\u003e\n"],["\u003cp\u003eWhile \u003ccode\u003etotal\u003c/code\u003e uses \u003ccode\u003eType\u003c/code\u003e for identification, other result tabulation types leverage \u003ccode\u003eOtherType\u003c/code\u003e for specification within the \u003ccode\u003eVoteCounts\u003c/code\u003e element.\u003c/p\u003e\n"]]],[],null,["# CountItemType\n\n| **Note:** This enumeration is only used with election results feeds. It isn't used with the pre-election data or officeholder feed types.\n\nThis enumeration is for the items that are counted during the course of an\nelection and for which the status of the counts are of interest. Used in the\n[`Counts`](/civics-data/reference/counts) and\n[`CountStatus`](/civics-data/reference/count-status) elements.\n\nThe following table describes the values for `CountItemType`:\n\n| Value | Description |\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `absentee` | For general absentee ballots without a more specific type. |\n| `absentee-in-person` | For absentee ballots that are cast in-person, such as at a city office. |\n| `absentee-mail` | For absentee ballots submitted by postal mail. |\n| `early` | For ballots cast during early voting periods. |\n| `election-day` | For ballots cast on election day. |\n| `provisional` | For challenged ballots. |\n| `total` | For the total of all ballot types. |\n| `write-in` | For write-ins on ballots. |\n| `other` | The count is a type that isn't included in this enumeration. If used, provide the item's custom type in an `OtherType` element. |\n\nResult tabulation types\n-----------------------\n\nThe following table lists enumerations for the election results reported by\n[`VoteCounts`](/civics-data/reference/counts#vote-counts).\n| **Note:** The `total` element is the only result tabulation that's defined as `Type` in this table. The rest use `OtherType`.\n\n| Type | Description | Sample XML |\n|---------------------|------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|\n| `total` | The count of votes cast for one votable. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_001\u003c/GpUnitId\u003e \u003cType\u003etotal\u003c/Type\u003e \u003cCount\u003e6173433\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `total-percent` | The percent of votes cast for one votable, as a number between 0 and 100. For example, report 24.2% as `24.2` and not 0.242. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_de_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003etotal-percent\u003c/OtherType\u003e \u003cCount\u003e24.2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `seats-won` | The number of seats for each party that have been declared winners. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_eu_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003eseats-won\u003c/OtherType\u003e \u003cCount\u003e2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `seats-leading` | The number of seats that are currently in the lead but haven't been declared winners. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_eu_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003eseats-leading\u003c/OtherType\u003e \u003cCount\u003e2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `seats-no-election` | Seats held that aren't up for election in this contest. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_eu_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003eseats-no-election\u003c/OtherType\u003e \u003cCount\u003e2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `seats-total` | A summation of seat types. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_eu_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003eseats-total\u003c/OtherType\u003e \u003cCount\u003e2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |\n| `seats-delta` | Change in number of seats due to this election. Can be positive or negative. | ```scdoc \u003cVoteCounts\u003e \u003cGpUnitId\u003eru_eu_999\u003c/GpUnitId\u003e \u003cType\u003eother\u003c/Type\u003e \u003cOtherType\u003eseats-delta\u003c/OtherType\u003e \u003cCount\u003e2\u003c/Count\u003e \u003c/VoteCounts\u003e ``` |"]]