Elections API v3.2 Release Notes
Results from Alternative Jurisdictions (Level 3)
You can now receive results from alternative jurisdictions (Level 3) in applicable elections using the level=allru parameter in the Elections request.
Alternative Jurisdictions (Level 3)
- Alaska: State legislative districts
- Connecticut: Wards in New Haven, Bridgeport, Hartford, Stamford and Waterbury
- District of Columbia: Wards
- Illinois: Chicago, Cook Suburbs, Galesburg, Knox County, Bloomington, McLean County, East St. Louis, St. Clair County, Danville, Vermilion County, Rockford, Winnebago County
- Maine: Adamstown Township, Albany Township, Atkinson Township, Barnard Township, Benedicta Township, Berry Township, Big Lake Township, Brookton Township, Carrying Place Township, Cary Township, Cathance Township, Cedar Lake Township, Centerville Township, Concord Township, Cross Lake Township, Day Block Township, E Township, Ebeemee Township, Edmunds Township, Elliottsville Township, Forest City Township, Forest Township, Forkstown Township, Freeman Township, Frenchtown Township, Grand Falls Township, Greenfield Township, Greenlaw Chopping Township, Grindstone Township, Harfords Point Township, Herseytown Township, Indian Purchase T3-T4 Townships, Kossuth Township, Lambert Lake Township, Lang Township, Lexington Township, Lily Bay Township, Long Pond Township, Madawaska Lake Township, Madrid Township, Magalloway Township, Marion Township, Mason Township, Mattamiscontis Township, Mayfield Township, Molunkus Township, Moosehead Junction Township, Moxie Gore, Orneville Township, Oxbow North Township, Perkins Township, Rockwood Strip Township, Sakom Township, Salem Township, Sandy Bay Township, Silver Ridge Township, Sinclair Township, T1 R5 WELS, T1 R8 WELS, T1 R9 WELS, T10 R15 WELS, T10 SD BPP, T11 R4 WELS, T15 R6 WELS, T16 R5 WELS, T18 MD BPP, T19 MD BPP, T22 MD BPP, T25 MD BPP, T26 ED BPP, T3 ND BPP, T4 R3 WELS, T4 R9 NWP, T7 R5 WELS, T7 SD BPP, Taunton and Raynham Academy Grant, TC R2 WELS, TD R2 WELS, Tomhegan Township, Trescott Township, Van Buren Cove Township, Washington Township
- Missouri: Kansas City, Jackson County
- New Hampshire: Wards in Berlin, Claremont, Concord, Dover, Franklin, Keene, Laconia, Lebanon, Manchester, Nashua, Portsmouth, Rochester, Somersworth
Example
The following request returns election data for the race ID 14012 in Illinois from the 3-17-2026 election at the state level (Level 1), each of the state RUs (Level 2) and the alternative jurisdictions Chicago and Cook Suburbs (Level 3). The XML format is returned by default. The format=json parameter returns results in the JSON format.
Request URL
https://api.ap.org/v3/elections/2026-03-17?statepostal=IL&raceID=14012&level=allru[&format=json]
XML Response
...
...
JSON Response
...
...
Candidate's Nickname
Elections API now returns the candidate's or incumbent's nickname; for example, "Chuck" for Charles Schumer. This in an additional field used only in national races, when needed to add clarity and when a candidate’s well-known and commonly used nickname is not used on the ballot in place of their formal name. The nickname is returned in the @Nickname field (XML) or the "nickname" property (JSON) in the Elections response.
XML Example
JSON Example
Maine Reporting Units
AP Elections is revising and updating its coverage of election reporting units in Maine beginning with the June 9, 2026, primary election. This update will more completely align AP's elections data with the geographies and naming conventions used by the U.S. Census Bureau, a change aimed at facilitating easier data analysis and mapping. For more information, see Maine Reporting Units.
Gzip Requirement Effective May 7, 2026
Elections API requires all requests to use gzip compression to ensure that data requests during large election events do not exceed Amazon Web Services thresholds, and responses to your requests load faster, especially with larger data sets.
To comply with this requirement, make sure the following request header is included:
-
Request Header: Accept-Encoding
-
Value: gzip
This request header is required for all Elections API methods (for example, Elections Request and Election Reports Request).
Beginning May 7, 2026, any requests to the Elections API that do not include this header will return the following error:
|
|
|
406 - 'P
This change will help ensure all AP Elections customers are fully prepared for the demands of election night.
Spring 2026 Reporting Unit Updates
AP Elections is preparing a series of updates to the historical election results archive and implementing a revised county naming convention for future elections, to align AP reporting unit names and FIPS codes with the U.S. Census Bureau standards. These changes will take effect beginning with elections held on May 2, 2026, and other corrections will be applied retroactively where appropriate on April 9, 2026. For more information, see Spring 2026 Reporting Unit Updates.
Voter Registration Requirements Report Updates
These fields have been added to the Voter Registration Requirements report:
-
AUTOMATIC_VOTER_REGISTRATION. Indicates whether the state has automatic voter registration (YES/NO).
-
SAME_DAY_REGISTRATION. Indicates the availability of same day registration (YES/NO).
-
PRIMARY_NOTE. Additional notes specific to primaries.
For more information and an example, see Voter Registration Requirements Report.
Candidate Report Updates
New Report Available
Previously, four types of of candidate reports were offered:
-
U.S. House candidates
-
U.S. Senate candidates
-
Gubernatorial candidates
-
Candidates running for President in each state
In addition to these report types, a new combined report is now available, providing candidate information for all of these offices in a single report.
New Fields Added
These new fields are now included in the reports:
-
StateNumber. State ID tied to race data.
-
OfficeID. Unique office type ID (P, G, S, H).
-
Office. Confirms the name of the office the candidate is running for.
-
SpecialPrimaryDate. Special primary date (MM/DD/YYYY).
-
SpecialGeneralDate. Special general election date (MM/DD/YYYY).
-
SpecialRunoffDate. Special runoff date (MM/DD/YYYY).
-
PolID. Unique National Politician ID across all states and races. Replaces the NPID field.
-
UncontestedPrimary. Indicates uncontested primary (Yes/No).
-
UncontestedGE. Indicates uncontested general election (Yes/No).
-
FilingStartDate. Filing start date (MM/DD/YYYY).
-
FilingDeadline. Filing deadline date (MM/DD/YYYY).
Examples
See Election Candidate Reports.
Deprecated Race Types
These race types and corresponding race type IDs have been deprecated:
-
Hybrid Nonpartisan Election (HNE)
-
Hybrid Nonpartisan Special Election (HNS)
-
Hybrid Nonpartisan Special Runoff Election (Y)
Updates to Switching to Certified Data
Using the resultsType=b parameter in the Elections request allows you to switch to certified data as it becomes available without having to change from resultsType=l to resultsType=c to get certified results.
Previously, when the resultsType=b and votetypes=true parameters were specified in the Elections request, the response included only certified cumulative results, but no vote type data because certified data is currently not available for vote by type.
Starting Feb. 12, 2026, you will receive a blend of certified cumulative data and live vote type data when you specify resultsType=b and votetypes=true in the request. The response also includes new fields to indicate the source (certified or live) for cumulative results and each vote type if applicable; for example:
Election Calendar Report Updates
In the Election Calendar report, the govOrSenIncl field has been replaced by the nationalOffices field. This field confirms which national-level races (represented by the office IDs) will be covered in the event; for example, P for President, S for U.S. Senate, H for U.S. House, G for Governor.
Additional updates include the following new fields:
-
additionalEventDetails. Includes details on races AP will be tabulating for the event.
-
specialOnly. Specifies whether the event includes only special elections.
-
balanceOfPower. (For special elections) If applicable, indicates that the special election will affect balance of power; for example, chamber control.
For more information, see Election Calendar Report.
Virtual Timestamps During Testing
During the scheduled test sessions, Elections API used to return timestamps with the date and time of the test in real time.
Starting Feb. 2, 2026, results returned during scheduled elections testing will include "virtual timestamps," so that the times noted in the results response are as if they are those during the election event. These "virtual timestamps" replace the previous timestamps, which reflected the time of the results response during the test event.
For example, during a test taking place on Oct. 10, 2025, for the November 2025 general election, the lastUpdated field in the test results response would show a date of 2025-11-04 rather than 2025-10-10. The time in the lastUpdated field would show the simulated time on election night, and not the time of the test results response.
This change affects the following response field values:
-
lastUpdated (JSON); LastUpdated (XML)
-
pollClosingTime (JSON); PollClosingTime (XML)
-
winnerDateTime (JSON); WinnerDateTime (XML)
-
minDateTime in the next request link