The file we provide is a Comma-Separated-Values file, or CSV. You can read it in Excel or Google Sheets or other spreadsheet processing program.
The name of the file depends on whether it is a list of township, precinct, or district voters.
Precincts are named Precinct_<precintname>.csv
Townships are named Township_<townshipname>.csv
District files are named District_<districtID>.csv
The District ID is an internal number, listed in the row in the Districts List. Look up the number to learn the district name.
Each row in the file represents an individual voter.
For each voter there are many columns. Here is how to interpret them:
- Voter ID - an internal voter number, for reference
- LastName - voter's last name
- FirstName - voter's first name
- MiddleName - voter's middle name or initial
- Suffix - Jr, Sr, III, IV, etc. if applicable
- Street number portion of address
- Street half number (for addresses like 123-1/2 S Main St)
- Street Direction portion of address
- Street Name
- Street Type (like ST, DR, LN, etc)
- Street Post Direction (for streets like Commerce St NW)
- City - city of residence
- Zip - zip code
- TownshipName - voter resides in this township
- PctName - voter resides in this precinct
- CID - voter resides in this Congressional District
- LID - voter resides in this Legislative District
- RID - voter resides in this Representative District
- BID - voter resides in this County Board District
- VH1, VH2, VH3, VH4 - voter's voting history for the last 4 voting cycles. If a value is in a column, the voter voted, otherwise they did not vote in that election. The value is MMYY for Month and Year of the election. A letter may appear after the MMYY to indicate a primary election and the party ballot returned ( D,R )
This information can only be used for bonafide political purposes and shall not be used under any circumstances for purposes of commercial solicitation or other business purposes and to do so may result in substantial penalty. (Chapter 10 ILCS 5/4-8, 5-7 and 6-35 Illinois Compiled Statutes)