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