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 2026 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, ElectionCalendar2026.
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 where the event is taking place; for example, IOWA.
statePostal	The state postal code; for example, IA.
calendarEvent	The event name.
additionalEventDetails	Includes details on races AP will be tabulating for the event.
specialOnly	Specifies whether the event includes only special elections. Possible values are Yes and No.
balanceOfPower	(For special elections) Indicates that a special election will affect balance of power. Possible values are "Yes - Chamber Control" and "Yes - Supermajority."
nationalOffices	Confirms which national-level races (represented by the office IDs) will be covered in the event. Possible values include P for President, S for U.S. Senate, H for U.S. House, G for Governor, L for Lieutenant Governor, A for Attorney General, SS for Secretary of State, M for Mayor, I for ballot measures of national interest.
tabulatedByAP	Indicates whether the event is tabulated by the AP. Possible values are Yes and No.
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).