Illinois Administrative Code
Title 26 - ELECTIONS
Part 219 - PROCEDURES FOR IMPLEMENTING THE ELECTRONIC CANVASS
Appendix A - Illinois eCanvass File Format
Master File Record Structure
Column Start |
Length |
Date Type |
Ballot Style |
Precinct |
Party |
1 |
2 |
Record Type (Integer) |
Record Type = 1 |
Record Type = 2 |
Record Type = 3 |
3 |
7 |
Unique System Id (Integer) |
Ballot Style ID [1] |
Precinct ID [6] |
(Vendor) Party ID [9] |
10 |
50 |
Name (String) |
Ballot Style Name [2] |
Precinct Name [7] |
Party Name [10] |
60 |
20 |
Code (String) |
|||
80 |
7 |
Display List Order (Integer) |
|||
87 |
7 |
Party ID (Vendor or State Number) |
Ballot Style (Vendor) Party ID [3] |
(SBE) Party ID [11] |
|
94 |
1 |
Varies/Record Dependent (Boolean 0 or 1) |
Is Federal [4] 0 = Non-Federal Ballot Style 1 = Federal Ballot Style |
||
95 |
2 |
Vote For (Integer) |
Proposition Only [5] 00 = No 01 = Yes |
||
97 |
7 |
Varies/Record Dependent (Integer) |
Registration [8] |
(Master File Record Structure Cont.)
District |
Contest |
Candidate |
Record Type = 4 |
Record Type = 5 |
Record Type = 6 |
District ID [12] |
(Vendor) Contest ID [15] |
(Vendor) Candidate ID [21] |
District Name [13] |
Contest Name [16] |
Candidate Name [22] |
(SBE) Contest ID [17] |
(SBE) Candidate ID [23] |
|
District List Order [14] |
Contest List Order [18] |
Candidate List Order [24] |
(SBE) Party ID [11] |
(Vendor) Candidate Party ID [25] |
|
Is Proposal [19] 0 = Normal Contest 1 = Proposal |
Is Write-in [31] 0 = Regular Candidate 1 = Write-In Candidate |
|
Vote For [20] |
||
District ID [12] |
(Vendor) Contest ID [15] |
Vote File Record Structure
Column Start |
Length |
Date Type |
1 |
7 |
Precinct ID (Integer) [6] |
8 |
7 |
Ballot Style ID (Integer) [1] |
15 |
7 |
(Vendor) Contest ID (Integer) [15] 0 = Turnout Record [26] |
22 |
7 |
(Vendor) Candidate Id (Integer) [21] 9999999 = Over Votes [27, 28] 9999998 = Under Votes [27, 29] 9999997 = Blank Ballot [27, 30] 0 = Turnout Record [26] |
29 |
7 |
Vote Count (Integer) |
Definitions
1 Ballot Style ID - A unique (to the jurisdiction) numeric identifier for the given ballot style
2 Ballot Style Name - A unique (to the jurisdiction) name assigned to the given ballot style
3 Ballot Style (Vendor) Party ID - Only applicable in a primary election, this party ID identifies the party for a given ballot style
4 Is Federal - Designates if a ballot style contains only federal contests
5 Proposition Only - Only applicable in a primary election, this identifies a ballot style as only having questions of public policy (referenda)
6 Precinct ID - Unique (to the jurisdiction) numeric identifier for the given precinct
7 Precinct Name - A unique (to the jurisdiction) name to identify the precinct
8 Registration - The number of registered voters within a precinct. This number should reflect only the "active" registered voters from that precinct
9 (Vendor) Party ID - Unique Identifier for the political parties active in a given election, assigned by the jurisdiction or tabulation vendor
10 Party Name - Name of a given political party
11 (SBEL) Party ID - ID assigned to a given political party by SBEL; SBEL party ID for a contest will reflect the party for a contest in a primary election; in a General Election this ID will be designated as "99" (Nonpartisan) since the office does not have a party affiliation in a General Election
12 District ID - Unique (to the jurisdiction) ID assigned by the jurisdiction to a given political district/unit of government
13 District Name - A unique text representation of the district/unit of government (e.g., 4TH APPELLATE COURT)
14 District List Order - A hierarchical number representing the order in which districts appear on the ballot
15 (Vendor) Contest ID - A unique ID number assigned to an office/contest by the jurisdiction or tabulation vendor
16 Contest Name - A unique text representation of the contest/office (e.g., 4TH APPELLATE COURT - SMITH VACANCY)
17 (SBEL) Contest ID - ID assigned to a given office/contest by SBEL; should be zero in the case that an ID is not assigned by SBEL for the given contest
18 Contest List Order - A hierarchical number representing the order in which offices/contests appear on the ballot
19 Is Proposal - Designates if a contest/office is actually a question of public policy (referenda)
20 Vote For - Number of candidates to be elected/nominated within a given office/contest
21 (Vendor) Candidate ID - Unique ID assigned to a candidate by jurisdiction/vendor
22 Candidate Name - Name of candidate or position on a referendum question
23 (SBEL) Candidate ID - ID assigned by SBEL for the given candidate; in the event that no ID is assigned by SBEL, this ID shall be zero
24 Candidate List Order - A hierarchical number representing the order in which candidates appear on the ballot
25 (Vendor) Candidate Party ID - ID assigned by the jurisdiction or vendor to the candidate
26 Turnout Record - In the vote file, a turnout record will have a contest ID of zero and a candidate ID of zero, and will have one record per precinct and ballot style combination; the turnout record will effectively report the number of times a ballot style was counted within a particular precinct
27 Reporting of Under Votes, Over Votes and Blank Ballots - Under votes, over votes and blank ballots shall be designated in the candidate ID field with codes of 9999998, 9999999 and 9999997, respectively, and shall have a corresponding contest ID
28 Under Votes - The number of times that the contest was on a tabulated ballot when votes cast are less than the Vote For number
29 Over Votes - The number of times that the contest was on a tabulated ballot when votes cast are more than the Vote For number
30 Blank Ballots - For a given contest, the number of times a ballot is cast when the contest has no candidates
31 Is Write-in - Identifies that the candidate is a write-in candidate