ElectionEvent

  • ElectionEvent entities are used solely in metadata feeds to describe a logical set of elections and referendums within a single Feed.

  • These entities detail the included geographies and office levels, along with the content availability dates within the Feed.

  • ElectionEvent entities can be combined if their attributes are the same, even if they cover different geographies and offices.

  • Key elements of an ElectionEvent include details about expected scopes, election types and dates, expected number of candidates, and important delivery and deadline dates.

ElectionEvent entities describe the attributes for a logical set of one or more elections and referendums within a single Feed. The entity specifies what geographies and office levels are included, as well as when the actual content for the set of elections is available in the Feed. ElectionEvent entities can be consolidated even if they cross geographic and office boundaries as long as all of the other attributes are the same (such as the initial delivery date of content or election type).

Elements

Name Tag Type Notes Multiplicity
DebugName 0 or 1 string A descriptive name for this event.
OfficeScopeCollection 0 or 1 N/A Wrapper for OfficeScope definitions that specify all of the offices being elected in this ElectionEvent.
BallotMeasureScopeCollection 0 or 1 N/A Wrapper for BallotMeasureScope definitions that specify all the ballot measure contests being voted on in this ElectionEvent.
ElectionType 1 or more ElectionType The type of election, such as partisan-primary or open-primary.
ElectionDateType 0 or 1 ElectionDateType Indicates the way that the election is added to the calendar, usually a snap or scheduled election.
ElectionDateStatus 0 or 1 DateStatus Indicates the status of the election date or dates.
ExpectedCandidates 0 or 1 integer The non-zero number of candidates in this election. An approximate estimate is okay. The entity can be empty if the number is unknown or if you have low confidence in the approximation.
InitialDeliveryDate 1 PartialDate When the partner expects to send the first data in the feed.
FullDeliveryDate 0 or 1 PartialDate When the full list of candidates is delivered but some attributes aren't yet finalized.
PublicationDate 0 or 1 PartialDate The first day the Electoral commission publishes the qualified candidates.
RegistrationStartDate 0 or 1 PartialDate The first day when "potential candidates" can file their candidacy.
RegistrationDeadlineDate 0 or 1 PartialDate The last day when "potential candidates" can file their candidacy.
WithdrawalDeadlineDate 0 or 1 PartialDate The last day when candidates can withdraw their candidacy.
StartDate 1 PartialDate The earliest expected start date of elections in this ElectionEvent.
EndDate 1 PartialDate The latest expected end date of elections in this ElectionEvent.