# ElectionEvent

> [!NOTE]
> **Note:** This entity is only used in metadata feeds. It isn't used with pre-election, election, or officeholder feeds.

`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

| Element | Multiplicity | Type | Description |
|---|---|---|---|
| `DebugName` | 0 or 1 | [`string`](https://developers.google.com/civics-data/reference/simple-data-types#xs-string) | A descriptive name for this event. |
| `OfficeScopeCollection` | 0 or 1 | N/A | Wrapper for [`OfficeScope`](https://developers.google.com/civics-data/reference/office-scope) definitions that specify all of the offices being elected in this `ElectionEvent`. |
| `BallotMeasureScopeCollection` | 0 or 1 | N/A | Wrapper for [`BallotMeasureScope`](https://developers.google.com/civics-data/reference/ballot-measure-scope) definitions that specify all the ballot measure contests being voted on in this `ElectionEvent`. |
| `ElectionType` | 1 or more | [`ElectionType`](https://developers.google.com/civics-data/reference/election-type) | The type of election, such as partisan-primary or open-primary. |
| `ElectionDateType` | 0 or 1 | [`ElectionDateType`](https://developers.google.com/civics-data/reference/election-date-type) | Indicates the way that the election is added to the calendar, usually a snap or scheduled election. |
| `ElectionDateStatus` | 0 or 1 | [`DateStatus`](https://developers.google.com/civics-data/reference/date-status) | 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`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | When the partner expects to send the first data in the feed. |
| `FullDeliveryDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | When the full list of candidates is delivered but some attributes aren't yet finalized. |
| `PublicationDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The first day the Electoral commission publishes the qualified candidates. |
| `RegistrationStartDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The first day when "potential candidates" can file their candidacy. |
| `RegistrationDeadlineDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The last day when "potential candidates" can file their candidacy. |
| `WithdrawalDeadlineDate` | 0 or 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The last day when candidates can withdraw their candidacy. |
| `StartDate` | 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The earliest expected start date of elections in this `ElectionEvent`. |
| `EndDate` | 1 | [`PartialDate`](https://developers.google.com/civics-data/reference/simple-data-types#partialdate) | The latest expected end date of elections in this `ElectionEvent`. |