OfficeHolderSubFeed Entity

AI-generated Key Takeaways

• OfficeHolderSubFeed entities are exclusively used in metadata feeds to describe the attributes of an officeholder Feed, specifying geographic and office-level details.

• They define the scope of offices held by officeholders within the feed, including information like office levels, jurisdictions, and roles.

• These entities also provide delivery timelines, including initial and comprehensive feed delivery dates, along with an estimate of the number of officeholders included.

• This entity is specifically for providing context and structure to officeholder data feeds, and is not used with other types of election-related data feeds.

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

Name	Tag	Type	Notes	Multiplicity
Debug name	DebugName	String	A descriptive name for this officeholder feed.	0 or 1
Expected office scopes	OfficeScopeCollection	OfficeScope	The list of OfficeScope entities that specify all of the offices being held by officeholders in this OfficeholderScope.	1
Initial feed delivery date	InitialDeliveryDate	PartialDate	When the partner expects to send the first draft of the feed.	1
Comprehensive delivery date	FullDeliveryDate	PartialDate	When the full list of officeholders is delivered but some attributes aren't yet finalized.	0 or 1
Expected number of officeholders	ExpectedOfficeholders	Number	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.	0 or 1

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"
  }
}