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, Primary runoff, General runoff, Primary recall or General recall
special	boolean	indicates whether the election is a special election
offices	array	represents the offices contested
reporting_levels	array of hashes	each reporting level has a boolean indicating if results available
vote_types	array of hashes	indicates whether early voting, absentee and provisional tallies are available
notes	string	notes about the election
source_url	string	url of data source
updated_at	datetime	a timestamp indicating when the given election was last updated