Candidate

This entity describes information about a candidate in a contest. A Candidate may be referenced by the CandidateSelection entity.

Candidate uses PartyId to reference the candidate's political party.

ExternalIdentifiers can be used to associate an ID with the candidate. If the type is not listed in the IdentifierType enumeration, use other and include the type (that is not listed in the enumeration) in OtherType.

The table below shows the attributes for Candidate:

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

The table below shows child elements for Candidate:

Element Multiplicity Type Description
BallotName 1 InternationalizedText For the candidate's name as listed on the ballot.
ExternalIdentifiers 0 or 1 ExternalIdentifiers For associating codes with the candidate.
FileDate 0 or 1 date Date when the candidate filed for the contest.
IsIncumbent 0 or 1 boolean Boolean to indicate whether the candidate is the incumbent for the office associated with the contest. Assumed to be "no" if not present.
IsTopTicket 0 or 1 boolean Boolean to indicate whether the candidate is the top of a ticket that includes multiple candidates. Assumed to be "no" if not present.
PartyId 0 or 1 IDREF Unique identifier for a Party element. For associating a party with the candidate.
PersonId 0 or 1 IDREF Unique identifier for a Person element. For associating more detailed information about the candidate.
PostElectionStatus 0 or 1 CandidatePostElectionStatus Final status of the candidate such as winner or withdrawn.
PreElectionStatus 0 or 1 CandidatePreElectionStatus Registration status of the candidate such as filed or qualified.

Examples

Pre-election

XML

    <Candidate objectId="can10861a">
      <BallotName>
        <Text language="en">Barack H. Obama</Text>
        <Text language="hi">बराक ओबामा</Text>
        <Text language="ja">バラク・オバマ</Text>
      </BallotName>
      <FileDate>2015-06-01</FileDate>
      <PartyId>par0003</PartyId>
      <PersonId>per10861a</PersonId>
      <PreElectionStatus>qualified</PreElectionStatus>
    </Candidate>

JSON

      "Candidate": [
          {
            "objectId": "can10861a",
            "BallotName": {
              "Text": [
                {
                  "value": "Barack H. Obama",
                  "language": "en"
                },
                {
                  "value": "बराक ओबामा",
                  "language": "hi"
                },
                {
                  "value": "バラク・オバマ",
                  "language": "ja"
                }
              ]
            },
            "FileDate": "2015-06-01",
            "PartyId": "par0003",
            "PersonId": "per10861a",
            "PreElectionStatus": "qualified"
          }
      ]

Post-election

XML

    <Candidate objectId="can-1001-kenyatta">
      <BallotName>
        <Text language="en">Uhuru Kenyatta</Text>
        <Text language="sw">Uhuru Kenyatta</Text>
      </BallotName>
      <IsIncumbent>1</IsIncumbent>
      <IsTopTicket>1</IsTopTicket>
      <PartyId>par-jubilee</PartyId>
      <PersonId>per-001-kenyatta</PersonId>
      <PostElectionStatus>projected-winner</PostElectionStatus>
      <PreElectionStatus>qualified</PreElectionStatus>
    </Candidate>

JSON

      "Candidate": [
          {
            "objectId": "can-1001-kenyatta",
            "BallotName": {
              "Text": [
                {
                  "value": "Uhuru Kenyatta",
                  "language": "en"
                },
                {
                  "value": "Uhuru Kenyatta",
                  "language": "sw"
                }
              ]
            },
            "IsIncumbent": 1,
            "IsTopTicket": 1,
            "PartyId": "par-jubilee",
            "PersonId": "per-001-kenyatta",
            "PostElectionStatus": "projected-winner",
            "PreElectionStatus": "qualified"
          }
      ]