Person

Use the Person entity to define information about a person. The person might be a candidate, election official, or authority for a reporting unit. The ElectionReport element includes PersonCollection, which contains the full set of Person objects in this feed. These Person objects are referenced in Candidate and GpUnit. A PersonCollection optionally includes ContactInformation to associate contact information.

Attributes

The following table describes the attributes for the Person element:

Attribute Required? Type Description
objectId Required ID Unique internal identifier that's used by other elements to reference this element.

Elements

The following table describes the elements for Person:

Element Multiplicity Type Description
ContactInformation 0 or more ContactInformation

Associates contact information with the person.

This must include an annotated URI that's annotated with wikipedia and specifies the canonical Wikipedia page of the person, if one exists. Also provide any other known personal social media URIs or websites. This information must be for that person specifically, not their office or department.

If you include an image of the person, annotate the URI with the candidate-image annotation.
DateOfBirth 0 or 1 PartialDate The person's date of birth.
ExternalIdentifiers 1 ExternalIdentifiers Associates an ID with the person. A stable identifier is required.
FirstName 0 or 1 string The person's first (given) name.
FullName 1 InternationalizedText The person's full name. For details on how to handle full names in multiple languages, see Local language content.
Gender 0 or 1 string

The person's gender. The following values are available for Gender:

  • For men: m, male, or man
  • For women: f, female, or woman
  • For any other gender: o, x, other, or nonbinary
LastName 0 or 1 string The person's last (family) name.
MiddleName 0 or more string The person's middle name.
Nickname 0 or 1 string Nickname associated with the person if they have a commonly known alias.
PartyId 1 IDREF Unique identifier for a Party element. Associates a political party with the person. Provide the objectId of the Party that this person is associated with.
Prefix 0 or 1 string A prefix associated with the person such as Mr. or Dr.
Profession 0 or 1 InternationalizedText The person's profession.
Suffix 0 or 1 string A suffix associated with the person such as Jr.
Title 0 or 1 InternationalizedText A title associated with the person.

Examples

XML

    <Person objectId="P12321">
      <ContactInformation>
        <Uri Annotation="candidate-image">https://example.come/candidates/ayron-silva.jpg</Uri>
        <Uri Annotation="official-facebook">https://fb.com/ayronsilvasample/</Uri>
        <Uri Annotation="official-instagram">https://www.instagram.com/ayron_silva_sample/</Uri>
        <Uri Annotation="official-twitter">https://twitter.com/ayronsilvasample</Uri>
        <Uri Annotation="official-website">https://ayron-silva-sample.com/</Uri>
        <Uri Annotation="official-youtube">https://www.youtube.com/user/ayron831/featured</Uri>
        <Uri Annotation="wikipedia">https://en.wikipedia.org/wiki/Ayron-Silva-Sample</Uri>
        <Uri Annotation="wikipedia">https://zh.wikipedia.org/zh/%E8%94%A1%E8%8B%B1%E6%96%87</Uri>
        <Uri Annotation="campaign">https://ayronsilvacampaign.com</Uri>
      </ContactInformation>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>stable-pers-P12321</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <FullName>
        <Text language="pt">Ayrton Silva</Text>
        <Text language="en">Ayrton Silva</Text>
        <Text language="hi">एर्टन सेना</Text>
        <Text language="ja">アイルトン・シルバ</Text>
      </FullName>
      <DateOfBirth>1960-01-01</DateOfBirth>
      <Gender>M</Gender>
      <LastName>Silva</LastName>
      <PartyId>par-dpp</PartyId>
    </Person>

JSON

    "Person": [
      {
        "objectId": "P12321",
        "ContactInformation": {
          "Uri": [
            "Annotation": "candidate-image"
            "value": "https://example.come/candidates/ayron-silva.jpg"
          ],
          "Uri": [
            "Annotation": "official-facebook"
            "value": "https://fb.com/ayronsilvasample/"
          ]
          "Uri": [
            "Annotation": "official-instagram"
            "value": "https://www.instagram.com/ayron_silva_sample"
          ]
          "Uri": [
            "Annotation": "official-twitter"
            "value": "https://twitter.com/ayronsilvasample"
          ]
          "Uri": [
            "Annotation": "official-website"
            "value": "https://ayron-silva-sample.com/"
          ]
          "Uri": [
            "Annotation": "official-youtube"
            "value": "https://www.youtube.com/user/ayron831/featured"
          ]
          "Uri": [
            "Annotation": "wikipedia"
            "value": "https://en.wikipedia.org/wiki/Ayron-Silva-Sample"
          ]
          "Uri": [
            "Annotation": "wikipedia"
            "value": "https://zh.wikipedia.org/zh/%E8%94%A1%E8%8B%B1%E6%96%87"
          ],
          "Uri": [
            "Annotation": "campaign"
            "value": "https://ayronsilvacampaign.com"
          ]
        }
        "ExternalIdentifiers": {
          "ExternalIdentifier" : [
            {
              "Type": "other",
              "OtherType": "stable",
              "Value": "stable-pers-P12321"
            }
          ]
        }
        "FullName": {
          "Text": [
            {
              "value": "Ayrton Silva",
              "language": "pt"
            },
            {
              "value": "Ayrton Silva",
              "language": "en"
            },
            {
              "value": "एर्टन सेना",
              "language": "hi"
            },
            {
              "value": "アイルトン・シルバ",
              "language": "ja"
            }
          ]
        },
        "DateOfBirth": "1960-01-01",
        "Gender": "M",
        "LastName": "Silva"
        "PartyId": "par-dpp"
      }
    ]