-
Notifications
You must be signed in to change notification settings - Fork 3
Elections Data Spec Version 1
dwillis edited this page Apr 22, 2013
·
11 revisions
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.
| Field | Type | Description |
|---|---|---|
| year | integer | year of the election |
| state | string | two-character state postal abbreviation |
| date | string | date of the election (yyyy-mm-dd) |
| results_type | string | the type of results available (Certified, Unofficial or null) |
| election_type | string | one of primary, general, runoff
|
| 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 |