ElectionGuide

Upcoming elections, election results and referendum results

ElectionGuide provides worldwide election dates and information, including upcoming elections and referendums within six months and the latest held national election or referendum in a specified year, with results when published.

Get election results

Get a country's most recent held national election or referendum in a year, including turnout and published candidate or party results. Some held elections do not have a published result breakdown; candidate party names may be unavailable.

Your information

Country

Country name, for example Germany.

More options

YearOptional

Election year, for example 2025. Omit for the most recent held election.

Election TypeOptional

Election category, for example legislative. Defaults to any.

1 credit per completed run

The same inputs also work from your code or an AI assistant. See For developers.

Example results

German Federal Diet

Germany, Feb 23, 2025

legislative

Turnout82.54%

Votes cast49,927,315

Registered voters60,490,603

Published results

Candidate or option	Party	Votes	Vote share	Seats won
Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)	Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)	11,194,700	22.6%	164
Alternative for Germany (Alternative für Deutschland)	Alternative for Germany (Alternative für Deutschland)	10,327,148	20.8%	152
Social Democratic Party	Social Democratic Party	8,148,284	16.4%	120
Alliance '90 / The Greens (Bündnis 90 / Die Grünen)	Alliance '90 / The Greens (Bündnis 90 / Die Grünen)	5,761,476	11.6%	85
The Left (Die Linke)	The Left (Die Linke)	4,355,382	8.8%	64
Christian Social Union in Bavaria	Christian Social Union in Bavaria	2,963,732	6%	44
South Schleswig Voters' Association (SSW) (Südschleswigscher Wählerverband)	South Schleswig Voters' Association (SSW) (Südschleswigscher Wählerverband)	76,126	0.2%	1

View source

About the ElectionGuide tool

List upcoming elections returns dates and statuses for elections and referendums within six months; filter by region or country.

Get election results returns turnout and published results; provide a country, with an optional year and election category.

Built from electionguide.org. Last checked Sep 29, 2026.

Actions

Get election results

1 credit

What you provide

Field	Type	Required	Description
Year`year`	Number	Optional	Election year, for example 2025. Omit for the most recent held election.Example: 2024
Country`country`	Text	Required	Country name, for example Germany.Example: Germany
Election Type`election_type`	Text	Optional	Election category, for example legislative. Defaults to any.Example: Presidential

What you get

Field	Type	Description
Date`date`	Date	Example: 2025-02-23
Link`link`	Link	Example: https://www.electionguide.org/elections/id/4574/
Note`note`	Text	Example: Candidate, party, or referendum option results are not published for this…
Country`country`	Text	Example: Germany
Results`results`	List
Name`results[].name`	Text	Example: Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)
Party`results[].party`	Text	Example: Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)
Votes`results[].votes`	Number	Example: 11194700
Seats Won`results[].seats_won`	Number	Example: 164
Vote Share (%)`results[].vote_share_percent`	Number	Example: 22.6
Votes Cast`votes_cast`	Number	Example: 49927315
Election Name`election_name`	Text	Example: German Federal Diet
Election Type`election_type`	Text	Example: Legislative
Turnout (%)`turnout_percent`	Number	Example: 82.54
Registered Voters`registered_voters`	Number	Example: 60490603

Example result

For Country: Germany

JSON

{
  "date": "2025-02-23",
  "link": "https://www.electionguide.org/elections/id/4574/",
  "note": null,
  "country": "Germany",
  "results": [
    {
      "name": "Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)",
      "party": "Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)",
      "votes": 11194700,
      "seats_won": 164,
      "vote_share_percent": 22.6
    },
    {
      "name": "Alternative for Germany (Alternative für Deutschland)",
      "party": "Alternative for Germany (Alternative für Deutschland)",
      "votes": 10327148,
      "seats_won": 152,
      "vote_share_percent": 20.8
    },
    {
      "name": "Social Democratic Party",
      "party": "Social Democratic Party",
      "votes": 8148284,
      "seats_won": 120,
      "vote_share_percent": 16.4
    }
  ],
  "votes_cast": 49927315,
  "election_name": "German Federal Diet",
  "election_type": "legislative",
  "turnout_percent": 82.54,
  "registered_voters": 60490603
}

List upcoming elections

1 credit

List upcoming elections and referendums in the next six months, with dates, statuses and links. Includes countries and territories listed by ElectionGuide.

What you provide

Field	Type	Required	Description
Region`region`	Text	Optional	Region to filter by, such as africa.Example: Africa
Country`country`	Text	Optional	Country name to filter by, such as Brazil. Leave blank for all countries.Example: Brazil
Max Results`max_results`	Number	Optional	Maximum number of elections to return, such as 25.Example: 100

What you get

Field	Type	Description
Elections`elections`	List
Link`elections[].link`	Text	Example: https://www.electionguide.org/elections/id/5091/
Type`elections[].type`	Text	Example: Presidential
Status`elections[].status`	Text	Example: Confirmed
Country`elections[].country`	Text	Example: Brazil
Election Date`elections[].election_date`	Date	Example: 2026-10-04
Election Name`elections[].election_name`	Text	Example: Brazilian Presidency

Example result

For Country: Brazil

JSON

{
  "elections": [
    {
      "link": "https://www.electionguide.org/elections/id/5091/",
      "type": "Presidential",
      "status": "Confirmed",
      "country": "Brazil",
      "election_date": "2026-10-04",
      "election_name": "Brazilian Presidency"
    },
    {
      "link": "https://www.electionguide.org/elections/id/5090/",
      "type": "Legislative - lower house",
      "status": "Confirmed",
      "country": "Brazil",
      "election_date": "2026-10-04",
      "election_name": "Brazilian Chamber of Deputies"
    },
    {
      "link": "https://www.electionguide.org/elections/id/5089/",
      "type": "Legislative - upper house",
      "status": "Confirmed",
      "country": "Brazil",
      "election_date": "2026-10-04",
      "election_name": "Brazilian Federal Senate"
    }
  ]
}

For developers

Call it from your code with one request. Change the values in input to run it on new data. To get an API key, open Developers at the bottom of Studio, turn on Developer mode and go to API keys.

cURL

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@electionguide",
  "visibility": "public",
  "operation": "get_election_results",
  "version": 1,
  "input": {
    "country": "Germany"
  },
  "response": {
    "format": "json"
  }
}'

What you can do with it

Track upcoming elections and referendums by country or region
Review election dates and statuses across countries
Compare published candidate or party votes, seats, and vote shares
Monitor voter turnout and registered voters by election
Find a country's most recent held national election

Questions about ElectionGuide

Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

Can I call this ElectionGuide tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

Do I need a ElectionGuide account?

No. You only need a Fous account.

How current is the data?

Fous gets the data from electionguide.org when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.