Skip to content
@openelections

OpenElections

The goal of OpenElections is to create the first free, comprehensive, standardized, linked set of election results data for the United States.

Welcome to OpenElections!

The goal of OpenElections is to create the first free, comprehensive, standardized, linked set of election data for the United States, including federal, statewide and state legislative offices. The current options for election data can be difficult to find and use or financially out-of-reach for most journalists and civic hackers. We want the people who work with election data to be able to get what they need, whether that's for stories and data analysis or web applications and interactive graphics.

OpenElections is a volunteer project, which means you can help us collect and convert official precinct results data. It was co-founded by Serdar Tumgoren and Derek Willis in 2012 and is managed by Willis, a lecturer in data journalism at the University of Maryland. OpenElections gratefully accepts donations online (use this form, putting "OpenElections" in the line for specific fund) and funding goes directly towards acquiring and converting official election results into data. OpenElections data has been used by The New York Times, The Wall Street Journal, several academic projects and other organizations. The data is and will remain free to anyone.

How this GitHub organization is organized

In general, our repositories are divided into two main categories: sources and data. All repositories that contain the word sources have original official election results files obtained from state and local election authorities and represent a variety of formats: PDFs, spreadsheets, text files and more. Repositories that have data in their names contain converted official data that has been standardized in certain ways (offices and parties in particular). The data comes in CSV files that can be opened in any spreadsheet or database program or read by any programming language. Not all states have a sources repository - some states produce a single statewide precinct-level data file - but all states have a data repository. Inside both kinds of repositories there are folders that represent years.

We use GitHub Issues to track progress in obtaining and converting official election results, and for any potential mistakes or omissions in the converted data. Your participation in that process is welcomed!

This GitHub organization also contains other repositories with utilities we've developed in our work and for other election-related information we've obtained. Although many of the tools we've developed are written in Python, we accept code contributions in any modern language.

Pinned Loading

  1. openelections-core openelections-core Public

    Core repo for election results data acquisition, transformation and output.

    Python 179 98

  2. docs docs Public

    Documentation for The OpenElections project

    HTML 15 13

  3. clarify clarify Public

    Discover and parse results for jurisdictions that use Clarity-based election systems.

    Python 38 22

  4. openelections-data-tx openelections-data-tx Public

    Pre-processed results for Texas elections

    R 30 27

  5. openelections-data-ny openelections-data-ny Public

    Election results for New York

    Python 41 34

  6. openelections-data-wv openelections-data-wv Public

    Converted CSVs of West Virginia election results

    Python 6 7

Repositories

Showing 10 of 133 repositories
  • openelections-data-ky Public

    Pre-processed results for Kentucky elections

    openelections/openelections-data-ky’s past year of commit activity
    Python 9 11 2 0 Updated Dec 5, 2024
  • openelections-data-ms Public

    Converted CSVs of Mississippi election results

    openelections/openelections-data-ms’s past year of commit activity
    Python 13 21 15 1 Updated Dec 3, 2024
  • openelections-data-mi Public

    Converted official precinct results for Michigan elections

    openelections/openelections-data-mi’s past year of commit activity
    Python 4 14 8 0 Updated Dec 3, 2024
  • openelections-sources-mi Public

    Pre-processed election results for Michigan elections

    openelections/openelections-sources-mi’s past year of commit activity
    HTML 1 4 7 0 Updated Nov 25, 2024
  • specs Public

    Specs for OpenElections Data

    openelections/specs’s past year of commit activity
    9 3 5 0 Updated Nov 20, 2024
  • openelections-sources-pa Public

    Source election results files from Pennsylvania

    openelections/openelections-sources-pa’s past year of commit activity
    HTML 3 4 6 0 Updated Nov 20, 2024
  • openelections-sources-ky Public

    Official results files from Kentucky jurisdictions

    openelections/openelections-sources-ky’s past year of commit activity
    0 1 4 0 Updated Nov 16, 2024
  • openelections-data-sc Public

    Pre-processed results for South Carolina elections

    openelections/openelections-data-sc’s past year of commit activity
    Python 3 6 4 3 Updated Nov 14, 2024
  • clarify Public

    Discover and parse results for jurisdictions that use Clarity-based election systems.

    openelections/clarify’s past year of commit activity
    Python 38 MIT 22 11 0 Updated Nov 14, 2024
  • openelections-data-az Public

    Pre-processed election results for Arizona

    openelections/openelections-data-az’s past year of commit activity
    Python 3 4 25 0 Updated Oct 4, 2024