OfficeholderSubFeed

Page Summary

• The OfficeHolderSubFeed entity is used in metadata feeds to describe attributes of an officeholder feed.

• It specifies included geographies and office levels, and when content is available.

• Key elements include DebugName, ExpectedOfficeScopes, InitialDeliveryDate, FullDeliveryDate, and ExpectedOfficeholders.

• OfficeScopeCollection lists OfficeScope entities detailing the offices held by officeholders in the feed.

• Examples show the structure for both XML and JSON formats.

Note: This entity is only used in metadata feeds. It isn't used with pre-election, election, or officeholder feeds.

OfficeholderSubFeed entities describe the attributes of an officeholder Feed They specify what geographies and office levels are included and when actual content is available in the Feed.

Elements

Element	Multiplicity	Type	Description
DebugName	0 or 1	string	A descriptive name for this officeholder feed.
OfficeScopeCollection	1	N/A	Wrapper element for OfficeScope definitions that specify all of the offices being held by officeholders in this OfficeholderSubFeed.
InitialDeliveryDate	1	PartialDate	When the partner expects to send the first draft of the feed.
FullDeliveryDate	0 or 1	PartialDate	When the full list of officeholders is delivered but some attributes aren't yet finalized.
ExpectedOfficeholders	0 or 1	integer	The non-zero number of officeholders. An approximate estimate is okay. This entity can be empty if the number is unknown or if you have low confidence in the estimate.

Examples

The following example is a Feed that contains an OfficeholderSubFeed with OfficeScope. It indicates that the Feed will be delivered in January 2024 and will contain the national level and state level officeholders for Australia:

XML

<OfficeholderSubFeed>
  <DebugName>AU national and state level officeholders</DebugName>
  <OfficeScopeCollection>
    <OfficeScope>
      <DebugName>National level OH</DebugName>
      <OfficeLevel>Country</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au</JurisdictionOcdId>
      <OfficeRoles>lower house</OfficeRoles>
      <OfficeRoles>upper house</OfficeRoles>
    </OfficeScope>
    <OfficeScope>
      <DebugName>South Austria OH</DebugName>
      <OfficeLevel>Administrative Area 1</OfficeLevel>
      <JurisdictionOcdId>ocd-division/country:au/state:sa</JurisdictionOcdId>
      <OfficeRoles>state lower house</OfficeRoles>
    </OfficeScope>
    ...
  </OfficeScopeCollection>
  <InitialDeliveryDate>2024-01</InitialDeliveryDate>
</OfficeholderSubFeed>

JSON

{
  "OfficeholderSubFeed": {
      "DebugName": "US national level officholders",
      "OfficeScopeCollection": {
        "OfficeScope": [
          {
            "DebugName": "National level OH",
            "OfficeLevel": "Country",
            "JurisdictionOcdId": "ocd-division/country:au",
            "OfficeRoles": [
                "lower house",
                "upper house"
            ]
          },
          {
            "DebugName": "South Austria OH",
            "OfficeLevel": "Administrative Area 1",
            "JurisdictionOcdId": "ocd-division/country:au/state:sa",
            "OfficeRoles": [
                "state lower house"
            ]
          }
          ...
        ]
      }
      "InitialDeliveryDate": "2024-01"
  }
}