ElectionAdministration

The Election Administration represents an institution for serving a locality’s (or state’s) election functions.

Tag

Data Type

Required?

Repeats?

Description

Error Handling

AbsenteeUri

xs:anyURI

Optional

Single

Specifies the web address for information on absentee voting.

If the field is invalid or not present, then the implementation is required to ignore it.

AmIRegisteredUri

xs:anyURI

Optional

Single

Specifies the web address for information on whether an individual is registered.

If the field is invalid or not present, then the implementation is required to ignore it.

BallotTrackingUri

xs:anyURI

Optional

Single

Specifies the web address for tracking information for a ballot cast by mail

If the field is invalid or not present, then the implementation is required to ignore it.

BallotProvisionalTrackingUri

xs:anyURI

Optional

Single

Specifies the web address for tracking information for a provisional ballot. To support EAC guidelines for “Processing Provisional Ballots” (https://www.eac.gov/research-and-data/provisional-voting/)

If the field is invalid or not present, then the implementation is required to ignore it.

Department

Department

Optional

Repeats

Describes the administrative body for a particular voter service.

If the element is invalid or not present, then the implementation is required to ignore it.

ElectionNotice

ElectionNotice

Optional

Single

A place for election administrators to post last minute and emergency notifications pertaining to the election.

If the element is invalid or not present, then the implementation is required to ignore it.

ElectionsUri

xs:anyURI

Optional

Single

Specifies web address the administration’s website.

If the field is invalid or not present, then the implementation is required to ignore it.

RegistrationUri

xs:anyURI

Optional

Single

Specifies web address for information on registering to vote.

If the field is invalid or not present, then the implementation is required to ignore it.

RulesUri

xs:anyURI

Optional

Single

Specifies a URI for the election rules and laws (if any) for the jurisdiction of the administration.

If the field is invalid or not present, then the implementation is required to ignore it.

WhatIsOnMyBallotUri

xs:anyURI

Optional

Single

Specifies web address for information on what is on an individual’s ballot.

If the field is invalid or not present, then the implementation is required to ignore it.

WhereDoIVoteUri

xs:anyURI

Optional

Single

The Specifies web address for information on where an individual votes based on their address.

If the field is invalid or not present, then the implementation is required to ignore it.

 1<ElectionAdministration id="ea40133">
 2   <AbsenteeUri>http://www.sbe.virginia.gov/absenteevoting.html</AbsenteeUri>
 3   <AmIRegisteredUri>https://www.vote.virginia.gov/</AmIRegisteredUri>
 4   <BallotTrackingUri>https://www.vote.virginia.gov/</BallotTrackingUri>
 5   <BallotProvisionalTrackingUri>https://www.vote.virginia.gov/</BallotProvisionalTrackingUri>
 6   <Department>
 7     <ContactInformation label="ci60000">
 8       <AddressLine>Washington Building First Floor</AddressLine>
 9       <AddressLine>1100 Bank Street</AddressLine>
10       <AddressLine>Richmond, VA 23219</AddressLine>
11       <Name>State Board of Elections</Name>
12     </ContactInformation>
13   </Department>
14   <ElectionNotice>
15     <NoticeText>
16       <Text language="en">This is an emergency notification for this election.</Text>
17     </NoticeText>
18     <NoticeURI>https://www.yadayada.gov</NoticeURI>
19   </ElectionNotice>
20   <ElectionsUri>http://www.sbe.virginia.gov/</ElectionsUri>
21   <RegistrationUri>https://www.vote.virginia.gov/</RegistrationUri>
22   <RulesUri>http://www.sbe.virginia.gov/</RulesUri>
23   <WhatIsOnMyBallotUri>https://www.vote.virginia.gov/</WhatIsOnMyBallotUri>
24   <WhereDoIVoteUri>https://www.vote.virginia.gov/</WhereDoIVoteUri>
25</ElectionAdministration>

Department

Tag

Data Type

Required?

Repeats?

Description

Error Handling

ContactInformation

ContactInformation

Optional

Single

Contact and physical address information for the election administration body (see ContactInformation).

If the element is invalid or not present, then the implementation is required to ignore it.

ElectionOfficialPersonId

xs:IDREF

Optional

Single

The individual to contact at the election administration office. The specified person should be the election official.

If the field is invalid or not present, then the implementation is required to ignore it.

VoterService

multi-xml-voter-service

Optional

Repeats

The types of services and appropriate contact individual available to voters.

If the element is invalid or not present, then the implementation is required to ignore it.

VoterService

Tag

Data Type

Required?

Repeats?

Description

Error Handling

ContactInformation

ContactInformation

Optional

Single

The contact for a particular voter service.

If the element is invalid or not present, then the implementation is required to ignore it.

Description

InternationalizedText

Optional

Single

Long description of the services available.

If the element is invalid or not present, then the implementation is required to ignore it.

ElectionOfficialPersonId

xs:IDREF

Optional

Single

The authority for a particular voter service.

If the field is invalid or not present, then the implementation is required to ignore it.

Type

VoterServiceType

Optional

Single

The type of voter service.

If the field is invalid or not present, then the implementation is required to ignore it.

OtherType

xs:string

Optional

Single

If Type is “other”, OtherType allows for cataloging another type of voter service.

If the field is invalid or not present, then the implementation is required to ignore it.

ContactInformation

For defining contact information about objects such as persons, boards of authorities, organizations, etc. ContactInformation is always a sub-element of another object (e.g. ElectionAdministration, Office, Person, Source). ContactInformation has an optional attribute label, which allows the feed to refer back to the original label for the information (e.g. if the contact information came from a CSV, label may refer to a row ID).

Tag

Data Type

Required?

Repeats?

Description

Error Handling

AddressLine

xs:string

Optional

Repeats

The “location” portion of a mailing address. See usage note.

If the field is invalid or not present, then the implementation is required to ignore it.

Directions

InternationalizedText

Optional

Single

Specifies further instructions for locating this entity.

If the element is invalid or not present, then the implementation is required to ignore it.

Email

xs:string

Optional

Repeats

An email address for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Fax

xs:string

Optional

Repeats

A fax line for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Hours [deprecated]

InternationalizedText

Optional

Single

Contains the hours (in local time) that the location is open (NB: this element is deprecated in favor of the more structured :ref:`multi-xml-hours-open` element. It is strongly encouraged that data providers move toward contributing hours in this format).

If the element is invalid or not present, then the implementation is required to ignore it.

HoursOpenId

xs:IDREF

Optional

Single

References an HoursOpen element, which lists the hours of operation for a location.

If the field is invalid or not present, then the implementation is required to ignore it.

LatLng

LatLng

Optional

Single

Specifies the latitude and longitude of this entity.

If the element is invalid or not present, then the implementation is required to ignore it.

Name

xs:string

Optional

Single

The name of the location or contact. See usage note.

If the field is invalid or not present, then the implementation is required to ignore it.

Phone

xs:string

Optional

Repeats

A phone number for the contact.

If the field is invalid or not present, then the implementation is required to ignore it.

Uri

xs:anyURI

Optional

Repeats

An informational URI for the contact or location.

If the field is invalid or not present, then the implementation is required to ignore it.

Name and AddressLine Usage Note

The Name and AddressLine fields should be chosen so that a display or mailing address can be constructed programmatically by joining the Name and AddressLine fields together. For example, for the following address:

Department of Elections
1 Dr. Carlton B. Goodlett Place, Room 48
San Francisco, CA 94102

The name could be “Department of Elections” and the first address line could be “1 Dr. Carlton B. Goodlett Place, Room 48.”

However, VIP does not yet support the representation of mailing addresses whose “name” portion spans more than one line, for example:

California Secretary of State
Elections Division
1500 11th Street
Sacramento, CA 95814

For addresses like the above, we recommend choosing a name like, “California Secretary of State, Elections Division” with “1500 11th Street” as the first address line. This would result in a programmatically constructed address like the following:

California Secretary of State, Elections Division
1500 11th Street
Sacramento, CA 95814
1<ContactInformation label="ci10861a">
2   <AddressLine>1600 Pennsylvania Ave</AddressLine>
3   <AddressLine>Washington, DC 20006</AddressLine>
4   <Email>president@whitehouse.gov</Email>
5   <Phone>202-456-1111</Phone>
6   <Phone annotation="TDD">202-456-6213</Phone>
7   <Uri>http://www.whitehouse.gov</Uri>
8</ContactInformation>

ElectionNotice

Tag

Data Type

Required?

Repeats?

Description

Error Handling

NoticeText

InternationalizedText

Required

Single

The last minute or emergency notification text should be placed here.

If the element is invalid, then the implementation is required to ignore the ElectionNotice element containing it.

NoticeUri

xs:anyURI

Optional

Single

Optional URL for additional information related to the last minute or emergency notification.

If the field is invalid or not present, then the implementation is required to ignore it.

VoterService

Tag

Data Type

Required?

Repeats?

Description

Error Handling

ContactInformation

ContactInformation

Optional

Single

The contact for a particular voter service.

If the element is invalid or not present, then the implementation is required to ignore it.

Description

InternationalizedText

Optional

Single

Long description of the services available.

If the element is invalid or not present, then the implementation is required to ignore it.

ElectionOfficialPersonId

xs:IDREF

Optional

Single

The authority for a particular voter service.

If the field is invalid or not present, then the implementation is required to ignore it.

Type

VoterServiceType

Optional

Single

The type of voter service.

If the field is invalid or not present, then the implementation is required to ignore it.

OtherType

xs:string

Optional

Single

If Type is “other”, OtherType allows for cataloging another type of voter service.

If the field is invalid or not present, then the implementation is required to ignore it.