OfficeHolderSubFeed Entity

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