election

The Election object represents an Election Day, which usually consists of many individual contests and/or referenda. A feed must contain exactly one Election object. All relationships in the feed (e.g., street segment to precinct to polling location) are assumed to relate only to the Election specified by this object. It is permissible, and recommended, to combine unrelated contests (e.g., a special election and a general election) that occur on the same day into one feed with one Election object.

Tag

Data Type

Required?

Repeats?

Description

Error Handling

date

xs:date

Required

Single

Specifies when the election is being held. The Date is considered to be in the timezone local to the state holding the election.

election_type

xs:string

Optional

Single

Specifies the highest controlling authority for election (e.g., federal, state, county, city, town, etc.)

state_id

xs:IDREF

Required

Single

Specifies a link to the State element where the election is being held.

is_statewide

xs:boolean

Optional

Single

Indicates whether the election is statewide.

If the field is not present or invalid, the implementation is required to default to “yes”.

name

xs:string

Optional

Single

The name for the election (NB: while optional, this element is highly recommended).

registration_info

xs:string

Optional

Single

Specifies information about registration for this election either as text or a URI.

absentee_ballot_info

xs:string

Optional

Single

Specifies information about requesting absentee ballots either as text or a URI

results_uri

xs:anyURI

Optional

Single

Contains a URI where results for the election may be found

polling_hours

xs:string

Optional

Single

Contains the hours (in local time) that Election Day polling locations are open. If polling hours differ in specific polling locations, alternative hours may be specified in the polling_location object (NB: this element is deprecated in favor of the more structured :ref:`multi-csv-hours-open` element. It is strongly encouraged that data providers move toward contributing hours in this format).

hours_open_ids

xs:IDREF

Optional

Single

References the multi-csv-hours-open element, which lists the hours of operation for polling locations.

has_election_day_registration

xs:boolean

Optional

Single

Specifies if a voter can register on the same day of the election (i.e., the last day of the election). Valid items are “yes” and “no”.

registration_deadline

xs:date

Optional

Single

Specifies the last day to register for the election with the possible exception of Election Day registration.

absentee_request_deadline

xs:date

Optional

Single

Specifies the last day to request an absentee ballot.

1 id,date,name,election_type,state_id,is_statewide,registration_info,absentee_ballot_info,results_uri,polling_hours,has_election_day_registration,registration_deadline,absentee_request_deadline,hours_open_id
2 e001,10-08-2016,Best Hot Dog,State,st51,true,www.registrationinfo.com,You can vote absentee,http://hotdogcontest.gov/results,Noon to 3p.m.,true,10/08/2016,,ho002