Election Calendar Report

Description

The Election Calendar report lists scheduled election events for a specific year. The events are listed in the chronological order, with the pending and canceled events included at the end of the list. For scheduled and pending events, the report indicates whether or not the event is tabulated by the AP.

Example and Data Elements

This XML example shows a partial 2024 Election Calendar report.

Note
This report is also available in JSON, with the XML version of the report returned by default when you follow the direct link to the report from the report list (for more information, see Election Reports). For brevity, report examples in the online documentation are provided in XML. JSON property names match the names of the XML elements.

This table describes the XML elements used in the Election Calendar report.

XML Element	Description
ElectionCalendaryear	The tag for this report; for example, ElectionCalendar2024.
lastCalendarUpdate/lastUpdated	The date when the report was last updated.
EventInformation	Contains information about the election event.
day	(Not for canceled events) The day of the week on which the event is taking place.
eventDate	(Not for canceled events) The event date, in the YYYY-MM-DD format.
state	The full name of the state (for example, IOWA) where the event is taking place.
calendarEvent	The event name.
tabulatedByAP	Indicates whether the event is tabulated by the AP. Possible values are yes and no.
statePostal	The state postal code (for example, IA).
eventStatus	(For tentative or canceled events only) Indicates whether the event is Tentative or has been Removed.
presPrimary	Indicates that the event includes a presidential nominating event. Possible values are "Dem", "GOP" and "Dem, GOP".
delegateEvent	Indicates that the event includes delegate allocation for presidential candidates. Possible values are "Dem", "GOP" and "Dem, GOP". In most cases, the value of this field will match the presPrimary field value; however, some states have additional events where some or all delegates are allocated on a separate day than the presidential primary (usually through a state convention).
govOrSenIncl	Indicates that the primary event includes a race for Governor and/or U.S. Senate. Possible values are "Gov", "Sen" and "Gov, Sen".