Use `OfficeHolderTenure` to define the specific seat and tenure of an
officeholder.

*** ** * ** ***

<br />

> [!NOTE]
> **Note:** This entity is only used for officeholder feeds.

If a person occupies more than one ongoing position at the same time, the feed
must provide information about each of these tenures. For example, if someone is
both Chancellor of Germany and Member of the Bundestag then they must have one
tenure per position.

When a person is designated as an officeholder for a new district or a new
position, link this person to the new office. Make sure to not reuse an outdated
office.

## Attributes

The following table describes the attributes for `OfficeHolderTenure`:

| 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 `OfficeHolderTenure`:

| Element | Multiplicity | Type | Description |
|---|---|---|---|
| `ContactInformation` | 0 or more | [`ContactInformation`](https://developers.google.com/civics-data/reference/contact-information) | Associates contact information with the officeholder. If this element is included, only specify information that's related to the officeholder, not the candidate or office. |
| `ElectoralDistrictId` | 1 | `IDREF` | Provide the `objectId` of the `GpUnit` that represents the electoral district. For example, give a state, like "Alaska," for a US Senator, or a district, like "New York's 14th congressional district," for a US Representative. > [!NOTE] > **Note:** `ElectoralDistrictId` is required. For all officeholders whose positions are not elected (e.g. appointed, hereditary), set the value equal to jurisdiction-id. For an officeholder who is appointed to a position that's normally elected (e.g. in the case of a vacancy) continue to provide the electoral district. For the officeholder feed, we expect one `OfficeHolderTenure` per seat and the `ElectoralDistrictId` set to the district that elected that person into office. **Example:** The Taiwan legislative election - Give each member of the Legislative Yuan a different `OfficeHolderTenure`, based on their district. **Another example:** US senate officeholder feed - Provide 100 `OfficeHolderTenure` objects for the US Senate. |
| `ExternalIdentifiers` | 1 | [`ExternalIdentifiers`](https://developers.google.com/civics-data/reference/external-identifier) | Associates an ID with the officeholder tenure. A [stable identifier](https://developers.google.com/civics-data/guides/stable-identifiers) is required. Stable identifiers for officeholder tenure must be unique across tenures. For example, each of the following need a distinct officeholder tenure stable identifier: - Grover Cleveland's presidency from 1885 to 1889 - Grover Cleveland's presidency from 1893 to 1897 - Franklin Roosevelt's presidency from 1933 to 1945 |
| `OfficeHolderPersonId` | 1 | `IDREF` | Provide the `objectId` of the [`Person`](https://developers.google.com/civics-data/reference/person) that holds this office tenure. |
| `OfficeId` | 1 | `IDREF` | Provide the `objectId` of the [`Office`](https://developers.google.com/civics-data/reference/office) that this tenure references. |
| `SeatStatus` | 0 or 1 | [`SeatStatus`](https://developers.google.com/civics-data/reference/seat-status) | The enumerated type of the officeholder's SeatStatus, such as `active` or `on-leave`. The default value is `active` if no SeatStatus is specified. |
| `OfficeSelectionMethod` | 1 | [`OfficeSelectionMethod`](https://developers.google.com/civics-data/reference/office-selection-method) | Information on how the officeholder is selected or placed into office for this tenure. |
| `StartDate` | 1 | `PartialDate` | Represents the start date for the current tenure of the office. Provide the date in the form `YYYY-MM-DD`. If the precise date isn't needed, provide the date in the form `YYYY-01-01`. Set `StartDate` based on when the politician started their *current* office tenure. Consider the following examples: - Suppose a current member of the European parliament (MEP) held the following offices: - From 1999 to 2007, they were an MEP. - From 2007 to 2018, they weren't in Parliament. - From 2018-12-12 until now, they've been an MEP. In this case, the 2018-to-present term is their current office tenure, so set `StartDate` to `2018-12-12`. - Suppose a member of parliament held the following offices: - From 2007 to 2013, they were a representative from a party list. - From 2013 to the present, they've represented an individual district. The 2013-to-present term is their current office tenure, so set `StartDate` to `2013-01-01`. - Suppose a current member of parliament held the following offices: - From 2007 to 2018, they were an MEP. - From 2018 until now, they've been re-elected in the *same electoral district* as an MEP. In this case, the tenure for the office of the MEP starts from 2007, so set `StartDate` to `2007`. |
| `EndDate` | 0 or 1 | `PartialDate` | Represents the end date of a person's tenure in a particular office. Don't include `EndDate` when the officeholder continues in their existing position but under a new term. Only include `EndDate` in the feed if it's known with certainty that the officeholder will leave office due to one of the following: - Losing an election - End of office eligibility - Resignation or removal - Death while in office Two months (60 days) after the specified `EndDate`, the associated [`Person`](https://developers.google.com/civics-data/reference/person) and `OfficeholderId` can be removed from the feed. If the `Person` is elected to another office, they need to be added back to the feed with the same stable ID. In the case of a dissolved government prior to an election: Don't include the `EndDate` until the election occurs and the official results have been released. For members that weren't re-elected in the election, include the `EndDate` set to the date where the government body was dissolved. Members that are re- elected will continue to not have an `EndDate`. |
| `OfficeTermType` | 0 or 1 | [`OfficeTermType`](https://developers.google.com/civics-data/reference/office-term-type) | The enumerated type of the officeholder's OfficeTermType. See the [reference](https://developers.google.com/civics-data/reference/office-term-type) for available options. |

## Examples

### XML

```xml
    <OfficeHolderTenure objectId="oh-0">
      <ElectoralDistrictId>ru-gpu0</ElectoralDistrictId>
      <ExternalIdentifiers>
        <ExternalIdentifier>
          <Type>other</Type>
          <OtherType>stable</OtherType>
          <Value>oh-0</Value>
        </ExternalIdentifier>
      </ExternalIdentifiers>
      <OfficeHolderPersonId>per-0</OfficeHolderPersonId>
      <OfficeSelectionMethod>directly-elected</OfficeSelectionMethod>
      <SeatStatus>active</SeatStatus>
      <StartDate>2019-01-02</StartDate>
    </OfficeHolderTenure>
```