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 Required Repeats Describes the administrative body for a particular voter service. There must be at least one valid Department in each ElectionAdministration element. If no valid Department objects are present, the implementation is required to ignore the ElectionAdministration object that contains it/them.
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
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
<ElectionAdministration id="ea40133">
   <AbsenteeUri>http://www.sbe.virginia.gov/absenteevoting.html</AbsenteeUri>
   <AmIRegisteredUri>https://www.vote.virginia.gov/</AmIRegisteredUri>
   <BallotTrackingUri>https://www.vote.virginia.gov/</BallotTrackingUri>
   <BallotProvisionalTrackingUri>https://www.vote.virginia.gov/</BallotProvisionalTrackingUri>
   <Department>
     <ContactInformation label="ci60000">
       <AddressLine>Washington Building First Floor</AddressLine>
       <AddressLine>1100 Bank Street</AddressLine>
       <AddressLine>Richmond, VA 23219</AddressLine>
       <Name>State Board of Elections</Name>
     </ContactInformation>
   </Department>
   <ElectionNotice>
     <NoticeText>
       <Text language="en">This is an emergency notification for this election.</Text>
     </NoticeText>
     <NoticeURI>https://www.yadayada.gov</NoticeURI>
   </ElectionNotice>
   <ElectionsUri>http://www.sbe.virginia.gov/</ElectionsUri>
   <RegistrationUri>https://www.vote.virginia.gov/</RegistrationUri>
   <RulesUri>http://www.sbe.virginia.gov/</RulesUri>
   <WhatIsOnMyBallotUri>https://www.vote.virginia.gov/</WhatIsOnMyBallotUri>
   <WhereDoIVoteUri>https://www.vote.virginia.gov/</WhereDoIVoteUri>
</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
2
3
4
5
6
7
8
<ContactInformation label="ci10861a">
   <AddressLine>1600 Pennsylvania Ave</AddressLine>
   <AddressLine>Washington, DC 20006</AddressLine>
   <Email>president@whitehouse.gov</Email>
   <Phone>202-456-1111</Phone>
   <Phone annotation="TDD">202-456-6213</Phone>
   <Uri>http://www.whitehouse.gov</Uri>
</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.