Stay organized with collections
Save and categorize content based on your preferences.
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.
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:
[[["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-07-09 UTC."],[[["\u003cp\u003e\u003ccode\u003eOfficeHolderSubFeed\u003c/code\u003e entities are exclusively used in metadata feeds to describe the attributes of an officeholder \u003ccode\u003eFeed\u003c/code\u003e, specifying geographic and office-level details.\u003c/p\u003e\n"],["\u003cp\u003eThey define the scope of offices held by officeholders within the feed, including information like office levels, jurisdictions, and roles.\u003c/p\u003e\n"],["\u003cp\u003eThese entities also provide delivery timelines, including initial and comprehensive feed delivery dates, along with an estimate of the number of officeholders included.\u003c/p\u003e\n"],["\u003cp\u003eThis entity is specifically for providing context and structure to officeholder data feeds, and is not used with other types of election-related data feeds.\u003c/p\u003e\n"]]],[],null,["| **Note:** This entity is only used in metadata feeds. It isn't used with pre-election, election, or officeholder feeds.\n\n`OfficeHolderSubFeed` entities describe the attributes of an officeholder `Feed`\nThey specify what geographies and office levels are included and when actual\ncontent is available in the `Feed`.\n\nElements\n\n| Name | Tag | Type | Notes | Multiplicity |\n|----------------------------------|-------------------------|-----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------|\n| Debug name | `DebugName` | `String` | A descriptive name for this officeholder feed. | 0 or 1 |\n| Expected office scopes | `OfficeScopeCollection` | [`OfficeScope`](/civics-data/reference/office-scope) | The list of `OfficeScope` entities that specify all of the offices being held by officeholders in this `OfficeholderScope`. | 1 |\n| Initial feed delivery date | `InitialDeliveryDate` | [`PartialDate`](/civics-data/reference/simple-data-types#partialdate) | When the partner expects to send the first draft of the feed. | 1 |\n| Comprehensive delivery date | `FullDeliveryDate` | [`PartialDate`](/civics-data/reference/simple-data-types#partialdate) | When the full list of officeholders is delivered but some attributes aren't yet finalized. | 0 or 1 |\n| 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 |\n\nExamples\n\nThe following example is a `Feed` that contains an `OfficeHolderSubFeed` with\n`OfficeScope`. It indicates that the `Feed` will be delivered in January 2024\nand will contain the national level and state level officeholders for Australia: \n\nXML \n\n```xml\n\u003cOfficeHolderSubFeed\u003e\n \u003cDebugName\u003eAU national and state level officeholders\u003c/DebugName\u003e\n \u003cOfficeScopeCollection\u003e\n \u003cOfficeScope\u003e\n \u003cDebugName\u003eNational level OH\u003c/DebugName\u003e\n \u003cOfficeLevel\u003eCountry\u003c/OfficeLevel\u003e\n \u003cJurisdictionOcdId\u003eocd-division/country:au\u003c/JurisdictionOcdId\u003e\n \u003cOfficeRoles\u003elower house\u003c/OfficeRoles\u003e\n \u003cOfficeRoles\u003eupper house\u003c/OfficeRoles\u003e\n \u003c/OfficeScope\u003e\n \u003cOfficeScope\u003e\n \u003cDebugName\u003eSouth Austria OH\u003c/DebugName\u003e\n \u003cOfficeLevel\u003eAdministrative Area 1\u003c/OfficeLevel\u003e\n \u003cJurisdictionOcdId\u003eocd-division/country:au/state:sa\u003c/JurisdictionOcdId\u003e\n \u003cOfficeRoles\u003estate lower house\u003c/OfficeRoles\u003e\n \u003c/OfficeScope\u003e\n ...\n \u003c/OfficeScopeCollection\u003e\n \u003cInitialDeliveryDate\u003e2024-01\u003c/InitialDeliveryDate\u003e\n\u003c/OfficeHolderSubFeed\u003e\n```\n\nJSON \n\n```json\n{\n \"OfficeHolderSubFeed\": {\n \"DebugName\": \"US national level officholders\",\n \"OfficeScopeCollection\": {\n \"OfficeScope\": [\n {\n \"DebugName\": \"National level OH\",\n \"OfficeLevel\": \"Country\",\n \"JurisdictionOcdId\": \"ocd-division/country:au\",\n \"OfficeRoles\": [\n \"lower house\",\n \"upper house\"\n ]\n },\n {\n \"DebugName\": \"South Austria OH\",\n \"OfficeLevel\": \"Administrative Area 1\",\n \"JurisdictionOcdId\": \"ocd-division/country:au/state:sa\",\n \"OfficeRoles\": [\n \"state lower house\"\n ]\n }\n ...\n ]\n }\n \"InitialDeliveryDate\": \"2024-01\"\n }\n}\n```"]]