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 run

Example results

Date: 2025-02-23
Link: electionguide.org
Note: Not provided
Country: Germany
Votes Cast: 49,927,315
Election Name: German Federal Diet
Election Type: legislative
Turnout (%): 82.54
Registered Voters: 60,490,603
Results: Results
Name Party Votes Seats Won Vote Share (%)
Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)
Christian Democratic Union (CDU) (Christlich Demokratische Union Deutschlands)
11,194,700
164
22.6
Alternative for Germany (Alternative für Deutschland)
Alternative for Germany (Alternative für Deutschland)
10,327,148
152
20.8
Social Democratic Party
Social Democratic Party
8,148,284
120
16.4
Alliance '90 / The Greens (Bündnis 90 / Die Grünen)
Alliance '90 / The Greens (Bündnis 90 / Die Grünen)
5,761,476
85
11.6
The Left (Die Linke)
The Left (Die Linke)
4,355,382
64
8.8
Christian Social Union in Bavaria
Christian Social Union in Bavaria
2,963,732
44
6
South Schleswig Voters' Association (SSW) (Südschleswigscher Wählerverband)
South Schleswig Voters' Association (SSW) (Südschleswigscher Wählerverband)
76,126
1
0.2

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

Example data · Run in Studio for fresh results.

About ElectionGuide

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 by Fous from electionguide.org and checked automatically; it last passed a check on Sep 29, 2026. Fous is not affiliated with ElectionGuide.

Actions

Get election results

1 credit per run

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 per run

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

Run this workflow from your own code. In Studio, turn on Developer mode and create an API key.

cURL

# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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

Is Fous affiliated with ElectionGuide?

No. Fous is not affiliated with ElectionGuide. This workflow reads the public electionguide.org website and returns its data.

How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check on Sep 29, 2026.