OfficeHolderTenure
Stay organized with collections
Save and categorize content based on your preferences.
Use OfficeHolderTenure to define the specific seat and tenure of an
officeholder.
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:
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.
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.
Associates an ID with the officeholder tenure. A
stable identifier
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
OfficeHolderPersonIds
1
IDREF
Provide the objectId of the
Person
that holds this office tenure.
OfficeId
1
IDREF
Provide the objectId of the
Office
that this tenure references.
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 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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-10-27 UTC."],[],[]]