Description
Label a ballot record's supplied overvote, undervote, valid or unresolved code.
Election and representation summaries depend on counting conventions: included ballots, quotas, seat totals, strict majority and source-defined statuses. A half-seat rule differs from an official quorum or certified result. Supplied counts and denominators support transparent arithmetic while legal rules, ballot validity and representativeness require separate evidence.
Label a ballot record's supplied overvote, undervote, valid or unresolved code.
When to use this tool
Use Ballot Overvote Undervote Code when you already have ballotRecordId, recordedCode and need to label a ballot record's supplied overvote, undervote, valid or unresolved code.
How to use the tool and how it works
- Enter ballotRecordId, recordedCode. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read label. Use the output convention below.
Require ballotRecordId nonempty and one allowed recordedCode; format ID [code].1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| ballotRecordId | Ballot Record Id | Required. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192. |
| recordedCode | Recorded Code | Required. Text; one of "overvote", "undervote", "valid", "unresolved"; maximum UTF-16 length 8192. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| label | Label | Required. Text; maximum UTF-16 length 8192. |
{
"input": {
"ballotRecordId": "B17",
"recordedCode": "undervote"
},
"output": {
"label": "B17 [undervote]"
}
}Limitations and assumptions
- No ballot is inspected, votes counted or official validity established.
- Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
Alternative or Complementary methods
Consult the governing count procedure and official source records for actual ballot treatment, quotas and majority rules. Reconcile all relevant ballots or seats before extending one share or surplus factor to a complete election or representation result.
References
Similar or alternative tools
- Legislative Vote Paired Absence Label
Label a legislator's recorded attendance or paired-absence status.
- Referendum Blank Ballot Denominator Rule
Calculate a referendum yes share with an explicit blank-ballot denominator rule.