ContactInformation

Use ContactInformation to define contact information about objects such as persons, boards of authorities, and organizations.

This entity is primarily used to provide annotated URIs that are related to the following elements: Election, ElectionAdministration, Person, GpUnit, and Office.

Attributes

The following table shows the attributes for ContactInformation:

Attribute Required? Type Description
label Optional string An optional attribute for contact information that can refer back to the original label for the information. For example, if the contact information came from a CSV, label might refer to a row ID.

Elements

The following table shows the elements for ContactInformation:

Element Multiplicity Type Description
AddressLine 0 or more string

Associates an address with the contact. AddressLine needs to contain the lines that someone would enter into a web mapping service like Google Maps to find the address on a map. That is, the value of the field needs to geocode the contact location.

To include an address for the contact, use multiple occurrences of AddressLine. We expect the first use of AddressLine to be the name or organization. We expect the subsequent uses to be the street address, city, postal code, city, state (or state equivalent, optional) in the specific order and format for the country.

Directions 0 or 1 InternationalizedText Provides directional information in addition to address information. Directions can be used to supply any additional address-related information that might appear in multiple languages.
Email 0 or more AnnotatedString Associates an email address with the contact. If more than one Email field is present, include annotations to let users know the purposes of each one.
Fax 0 or more AnnotatedString Associates a fax number with the contact. If more than one Fax field is present, include annotations to let users know the purposes of each one.
LatLng 0 or 1 LatLng Associates optional latitude and longitude information with a contact address.
Name 0 or 1 string Associates a name with the contact. Use this field for non-address information that can help a user contact that person or organization. For instance, "Secretary of State Office, Election Department."
Phone 0 or more AnnotatedString Associates a phone number with the contact. If more than one Phone field is present, include annotations to let users know the purposes of each one.
Uri 0 or more AnnotatedUri Associates a URI with the contact.

Examples

XML

    <ContactInformation>
      <Uri Annotation="personal-facebook">https://www.facebook.com/tedcruzpage</Uri>
      <Uri Annotation="personal-twitter">https://twitter.com/tedcruz</Uri>
      <Uri Annotation="personal-website">https://www.tedcruz.org/</Uri>
      <Uri Annotation="wikipedia">https://en.wikipedia.org/wiki/Ted_Cruz</Uri>
    </ContactInformation>
    <ContactInformation label="ci60001">
      <AddressLine>Viad. Tlalpan 100</AddressLine>
      <AddressLine>Arenal Tepepan</AddressLine>
      <AddressLine>14610 Ciudad de México, CDMX</AddressLine>
      <AddressLine>Mexico</AddressLine>
      <Name>Instituto Nacional Electoral</Name>
      <Phone annotation="domestic">01 800 433 2000</Phone>
      <Phone annotation="usa">1 (866) 986 8306</Phone>
      <Phone annotation="collect">+52 (55) 5481 9897</Phone>
      <Uri Annotation="official-website">https://www.ine.mx/</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/INEMexico</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/INEMexico</Uri>
    </ContactInformation>
    <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 Annotation="official-website">http://www.whitehouse.gov</Uri>
      <Uri Annotation="official-facebook">https://www.facebook.com/WhiteHouse</Uri>
      <Uri Annotation="official-twitter">https://twitter.com/WhiteHouse</Uri>
    </ContactInformation>

JSON

    "ContactInformation": {
      "Uri": [
        "Annotation": "personal-facebook"
        "value": "https://www.facebook.com/tedcruzpage"
      ],
      "Uri": [
        "Annotation": "personal-twitter"
        "value": "https://twitter.com/tedcruz"
      ],
      "Uri": [
        "Annotation": "personal-website"
        "value": "https://www.tedcruz.org/"
      ],
      "Uri": [
        "Annotation": "wikipedia"
        "value": "https://en.wikipedia.org/wiki/Ted_Cruz"
      ]
    }
    "ContactInformation": {
      "label": "ci60001",
      "AddressLine": [
        "Viad. Tlalpan 100",
        "Arenal Tepepan",
        "14610 Ciudad de México, CDMX",
        "Mexico"
      ],
      "Name": "Instituto Nacional Electoral",
      "Phone": [
        {
          "annotation": "domestic",
          "value": "01 800 433 2000"
        },
        {
          "annotation": "usa",
          "value": "1 (866) 986 8306"
        },
        {
          "annotation": "collect",
          "value": "+52 (55) 5481 9897"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "https://www.ine.mx/"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/INEMexico"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/INEMexico"
      ]
    }
    "ContactInformation": {
      "label": "ci10861a",
      "AddressLine": [
        "1600 Pennsylvania Ave",
        "Washington, DC 20006"
      ],
      "Email": "president@whitehouse.gov",
      "Phone": [
        {
          "value": "202-456-1111"
        },
        {
          "annotation": "TDD",
          "value": "202-456-6213"
        }
      ],
      "Uri": [
        "Annotation": "official-website"
        "value": "http://www.whitehouse.gov"
      ],
      "Uri": [
        "Annotation": "official-facebook"
        "value": "https://www.facebook.com/WhiteHouse"
      ],
      "Uri": [
        "Annotation": "official-twitter"
        "value": "https://twitter.com/WhiteHouse"
      ]
    }