Elections Data Spec Version 2

THIS IS A DRAFT AND IS NOT YET FINAL

Introduction

The following spec describes the elections in a state during a particular year. Inside a particular year's directory within a state there is a file called "elections" listing the elections that occurred in that year and information about the status and scope of results data. An example url would be: https://s3.amazonaws.com/openelex-data/us/states/md/2012/elections.json for JSON and https://s3.amazonaws.com/openelex-data/us/states/md/2012/elections.csv for CSV.

Fields

Field	Type	Description
id	string	OpenElections identifier (structure tbd)
year	integer	year of the election
start_date	date	beginning date of the election (yyyy-mm-dd)
end_date	date	ending date of the election (usually the same as start_date)
division	string	political jurisdiction using Open Civic Data Division Identifiers
results_type	string	the type of results available (Certified, Unofficial or null)
election_type	string	one of Primary, General, Runoff, Primary recall or General recall
special	boolean	indicates whether the election is a special election
office	string	represents the office contested
race_wide	boolean	indicates whether race-level results are available
county	boolean	indicates whether county-level results are available
congressional_district	boolean	indicates whether congressional district-level results are available
state_legislative	boolean	indicates whether state legislative district-level results are available
precinct	boolean	indicates whether precinct-level results are available
updated_at	datetime	a timestamp indicating when the given election was last updated