# ElectionGuide API: Get election results > Gets a country's most recent held national election or referendum on ElectionGuide, optionally for a year and election type, with turnout and published candidate, party or option results. Unofficial. Not affiliated with or endorsed by ElectionGuide. - Page: https://fous.com/methods/electionguide.org/get-election-results - Method: `electionguide.org/get_election_results`, version 1 - Website: electionguide.org - Returns: election name, type, date, registered voters, votes cast, turnout, results with votes, vote share and seats, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `year` | integer | no | | Election year, for example 2025. Omit for the most recent held election. | | `country` | string | yes | `"Germany"` | Country name, for example Germany. | | `election_type` | string | no | | Election category, for example legislative. Defaults to any. One of "any", "presidential", "legislative", "referendum". Default "any". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "country": "Germany" } ``` Its output: ```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 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"electionguide.org/get_election_results","input":{"country":"Germany"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What were the results of Germany's 2025 legislative election, including turnout and seats won by each party? - Pull up the latest presidential election in Brazil from electionguide.org with vote shares for each candidate - How did the most recent referendum in Switzerland turn out? I need registered voters, votes cast, and the yes/no breakdown - Show me Kenya's 2022 presidential election numbers: turnout and how many votes each candidate got - Check ElectionGuide for the last national election held in Indonesia and give me the party results ## Input schema ```json { "type": "object", "required": [ "country" ], "properties": { "year": { "type": "integer", "maximum": 2100, "minimum": 1900, "description": "Election year, for example 2025. Omit for the most recent held election." }, "country": { "type": "string", "description": "Country name, for example Germany." }, "election_type": { "enum": [ "any", "presidential", "legislative", "referendum" ], "type": "string", "default": "any", "description": "Election category, for example legislative. Defaults to any." } } } ``` ## Output schema ```json { "type": "object", "required": [ "country", "election_name", "election_type", "date", "registered_voters", "votes_cast", "turnout_percent", "results", "note", "link" ], "properties": { "date": { "type": "string", "format": "date" }, "link": { "type": "string", "format": "uri" }, "note": { "type": [ "string", "null" ] }, "country": { "type": "string" }, "results": { "type": "array", "items": { "type": "object", "required": [ "name", "party", "votes", "vote_share_percent", "seats_won" ], "properties": { "name": { "type": "string" }, "party": { "type": [ "string", "null" ] }, "votes": { "type": [ "integer", "null" ] }, "seats_won": { "type": [ "integer", "null" ] }, "vote_share_percent": { "type": [ "number", "null" ] } }, "additionalProperties": false } }, "votes_cast": { "type": [ "integer", "null" ] }, "election_name": { "type": "string" }, "election_type": { "enum": [ "presidential", "legislative", "referendum" ], "type": "string" }, "turnout_percent": { "type": [ "number", "null" ] }, "registered_voters": { "type": [ "integer", "null" ] } }, "additionalProperties": false } ``` ## See more - [World Bank API: Get country statistic](https://fous.com/methods/data.worldbank.org/get-country-statistic.md): Looks up a World Bank statistic for a country and returns its annual values and latest value for the selected years. - [Ballotpedia API: List ballot measures](https://fous.com/methods/ballotpedia.org/list-ballot-measures.md): Lists statewide ballot measures in a US state and year, in Ballotpedia order, with election dates, topics, measure types, yes/no vote meanings and results. Years without statewide measures return an empty list. - [World Bank API: Compare countries by a statistic](https://fous.com/methods/worldbank.org/compare-countries.md): Ranks countries by a World Development Indicators statistic for a given year, or for the latest year with broad country coverage. Regional aggregates and countries without data for that year are left out. - [Passport Index API: Get passport rank](https://fous.com/methods/passportindex.org/get-passport-rank.md): Looks up a country's passport on Passport Index and returns its global rank, mobility score, visa requirement counts and optionally every destination's requirement. - [Formula 1 API: Get race results](https://fous.com/methods/formula1.com/get-race-results.md): Returns the main-race finishing order and fastest lap for a Formula 1 Grand Prix. Defaults to the most recent completed race in the current season. - [Trading Economics API: Get country economic overview](https://fous.com/methods/tradingeconomics.com/get-country-overview.md): Returns seven key economic indicators for a country from its public Trading Economics overview: GDP growth rate, inflation rate, interest rate, unemployment rate, government debt to GDP, currency and stock market. Indicators absent from the overview are null; the US dollar index is not reported as a USD exchange rate. - [atptour.com API: Get ATP tournament results](https://fous.com/methods/atptour.com/get-tournament-results.md): Gets singles match results round by round for an ATP tournament and year, including the champion, dates, surface and category. Without a year it uses the most recent listed edition. - [Our World in Data API: Get statistic](https://fous.com/methods/ourworldindata.org/get-statistic.md): Finds the Our World in Data chart that best matches a statistic and returns its country-by-year numeric values, definition and source.