Server definition
- Hash
- sha256:e2258b1a20025b74f74556c970c20dc7db5efa29a57807053832ccd3de09c847
- What it is
- What a remote MCP server returned when asked what it offers: 8 tools
The blob, as servednamed by its sha256
{
"instructions": "Global Election Index is a neutral, sourced reference for elections: when they are held, when provisional and final results are expected and on what legal basis, who counts the votes, and which official page publishes the result. It covers 411 elections in 100 countries, 2021–2030, including 23 of the 27 EU member states, the 2026 US midterms in all 50 states and the certified 2024 US presidential result, with vote counts, in all 50 states and DC. Use next_election for \"when is the next election in X\", upcoming_elections for date ranges, election_status for the full record, and when_final or check_question to tell a provisional count from a final result. Certified counts for past elections are in election_status (e.g. \"us-presidential-2024-az\" for Arizona, \"us-presidential-2024\" for the national total). Answers are calendar expectations unless \"observed\" is true.",
"tools": [
{
"description": "Is a question about a given count stage answerable at a given time? Returns verdict ok / too-early / inside-window / too-late, settle_after, and the resolvable sources. Built to stop questions that read the provisional count when they mean the final one.",
"inputSchema": {
"properties": {
"ask_at": {
"description": "ISO date-time; default now",
"type": "string"
},
"election": {
"description": "Election id, e.g. \"brazil-general-2026\"; list ids with upcoming_elections",
"type": "string"
},
"race": {
"description": "Race id, e.g. \"president\"; optional when the election has one race",
"type": "string"
},
"stage": {
"description": "Default final-result",
"enum": [
"exit-poll",
"election-night",
"media-call",
"intermediate-count",
"final-result",
"court-validation",
"government"
],
"type": "string"
}
},
"required": [
"election"
],
"type": "object"
},
"name": "check_question",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"ask_at": {
"description": "Time the question would be asked (ISO)",
"type": "string"
},
"detail": {
"description": "Explanation",
"type": "string"
},
"election": {
"description": "Election id",
"type": "string"
},
"race": {
"description": "Race id",
"type": "string"
},
"replaced_at": {
"description": "When a later stage replaces this one",
"type": [
"string",
"null"
]
},
"resolution_sources": {
"items": {
"properties": {
"check": {
"description": "Latest link check",
"type": [
"object",
"null"
]
},
"kind": {
"description": "race_results, feed, results_index, emb_home, directory or media",
"type": "string"
},
"kindReason": {
"description": "Why it was classified that way",
"type": "string"
},
"origin": {
"description": "race, stage or authority",
"type": "string"
},
"resolvable": {
"description": "Can this page answer a results question?",
"type": "boolean"
},
"role": {
"description": "What the page is for",
"type": "string"
},
"url": {
"description": "Source URL",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"settle_after": {
"description": "Earliest time the question can be settled",
"type": [
"string",
"null"
]
},
"stage": {
"description": "Count stage asked about",
"type": "string"
},
"verdict": {
"description": "ok, too-early, inside-window, too-late or no-window",
"type": "string"
},
"window": {
"description": "Expected window for one count stage",
"properties": {
"by": {
"description": "Latest expected time (ISO)",
"type": [
"string",
"null"
]
},
"citation": {
"description": "Basis for the window",
"type": "string"
},
"confidence": {
"description": "announced (law or authority), precedent (last election) or estimate",
"type": "string"
},
"from": {
"description": "Earliest expected time (ISO)",
"type": [
"string",
"null"
]
},
"observedAt": {
"description": "When the authority actually published it; null until observed",
"type": [
"string",
"null"
]
},
"observedSource": {
"description": "URL that proves the observation",
"type": [
"string",
"null"
]
},
"replacedAt": {
"description": "When a later stage replaces it on the authority page",
"type": [
"string",
"null"
]
},
"source": {
"description": "Source of a stage published outside the authority page",
"type": [
"string",
"null"
]
},
"stage": {
"description": "Count stage id",
"type": "string"
}
},
"type": [
"object",
"null"
]
}
},
"required": [
"election",
"race",
"verdict"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "Coverage, stale records, races still lacking a results page, and publisher-gate warnings, as counts with the first 20 of each (full report at /v1/health). Use to judge how far to trust an answer.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "dataset_health",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"authorities": {
"description": "Counting authorities",
"type": "integer"
},
"discovered_unprofiled": {
"description": "Found, not yet profiled",
"type": "integer"
},
"elections": {
"description": "Profiled elections",
"type": "integer"
},
"full_report": {
"description": "URL of the full report with every warning",
"type": "string"
},
"links_checked": {
"description": "Links checked by the Auditor",
"type": "integer"
},
"races": {
"description": "Races",
"type": "integer"
},
"races_with_resolvable_results_source": {
"description": "Races with a page that can answer a results question",
"type": "integer"
},
"races_without": {
"description": "First 20 races lacking one",
"items": {
"type": "string"
},
"type": "array"
},
"races_without_total": {
"description": "All races lacking one",
"type": "integer"
},
"stale": {
"description": "First 20 stale records",
"items": {
"type": "object"
},
"type": "array"
},
"stale_total": {
"description": "All stale records",
"type": "integer"
},
"warnings": {
"description": "First 20 publisher-gate warnings",
"items": {
"type": "object"
},
"type": "array"
},
"warnings_by_level": {
"description": "Warning count per level",
"type": "object"
},
"warnings_total": {
"description": "All publisher-gate warnings",
"type": "integer"
}
},
"required": [
"elections",
"races"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "Full record of one election: races, polls-close times, every count stage window (exit poll, election night, intermediate count, final result, government) with confidence and citation, the authority, sources, recorded vote counts, and whether the record is stale.",
"inputSchema": {
"properties": {
"election": {
"description": "Election id, e.g. \"latvia-parliamentary-2026\"",
"type": "string"
}
},
"required": [
"election"
],
"type": "object"
},
"name": "election_status",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2",
"type": "string"
},
"country_name": {
"description": "Country name",
"type": "string"
},
"date": {
"description": "Polling day (YYYY-MM-DD); for an expected date, the last day of date_window",
"type": "string"
},
"date_status": {
"description": "declared, tentative, or expected (no day set yet: see date_window)",
"type": "string"
},
"date_window": {
"description": "Only for date_status \"expected\": the period polling day is expected in",
"properties": {
"from": {
"description": "First possible day (YYYY-MM-DD)",
"type": "string"
},
"label": {
"description": "How we name the period, e.g. \"Q2 2029\"",
"type": [
"string",
"null"
]
},
"to": {
"description": "Last possible day (YYYY-MM-DD)",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"id": {
"description": "Election id",
"type": "string"
},
"kind": {
"description": "Kind of election",
"type": "string"
},
"last_verified_at": {
"description": "When the record was last checked against its sources",
"type": "string"
},
"level": {
"description": "national or regional",
"type": "string"
},
"races": {
"items": {
"properties": {
"expected_stage_now": {
"description": "Count stage expected on the authority page now",
"type": [
"string",
"null"
]
},
"id": {
"description": "Race id",
"type": "string"
},
"name": {
"description": "Race name",
"type": "string"
},
"results": {
"description": "Published counts we hold, oldest first (empty until a count is recorded)",
"items": {
"properties": {
"electorate": {
"description": "Registered voters",
"type": [
"integer",
"null"
]
},
"licence": {
"description": "Licence of the numbers",
"type": "string"
},
"published_at": {
"description": "When the publisher released it",
"type": [
"string",
"null"
]
},
"publisher": {
"description": "Who published the count",
"type": "string"
},
"rows": {
"items": {
"properties": {
"candidate": {
"description": "Candidate or list",
"type": "string"
},
"colour": {
"description": "Party colour (#RRGGBB, from Wikidata)",
"type": [
"string",
"null"
]
},
"party": {
"description": "Party, where recorded",
"type": [
"string",
"null"
]
},
"party_id": {
"description": "Wikidata QID of the party",
"type": [
"string",
"null"
]
},
"seats": {
"description": "Seats or electoral votes won",
"type": [
"integer",
"null"
]
},
"share": {
"description": "Percent of total votes",
"type": [
"number",
"null"
]
},
"votes": {
"description": "Votes",
"type": "integer"
},
"winner": {
"description": "Most votes in this count",
"type": "boolean"
}
},
"type": "object"
},
"type": "array"
},
"source": {
"description": "File or page the numbers were copied from",
"type": "string"
},
"stage": {
"description": "Count stage of this version, e.g. final-result",
"type": "string"
},
"total_votes": {
"description": "Total votes cast in the race",
"type": "integer"
},
"turnout": {
"description": "Percent of registered voters who cast a ballot",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"properties": {
"check": {
"description": "Latest link check",
"type": [
"object",
"null"
]
},
"kind": {
"description": "race_results, feed, results_index, emb_home, directory or media",
"type": "string"
},
"kindReason": {
"description": "Why it was classified that way",
"type": "string"
},
"origin": {
"description": "race, stage or authority",
"type": "string"
},
"resolvable": {
"description": "Can this page answer a results question?",
"type": "boolean"
},
"role": {
"description": "What the page is for",
"type": "string"
},
"url": {
"description": "Source URL",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stages": {
"items": {
"description": "Expected window for one count stage",
"properties": {
"by": {
"description": "Latest expected time (ISO)",
"type": [
"string",
"null"
]
},
"citation": {
"description": "Basis for the window",
"type": "string"
},
"confidence": {
"description": "announced (law or authority), precedent (last election) or estimate",
"type": "string"
},
"from": {
"description": "Earliest expected time (ISO)",
"type": [
"string",
"null"
]
},
"observedAt": {
"description": "When the authority actually published it; null until observed",
"type": [
"string",
"null"
]
},
"observedSource": {
"description": "URL that proves the observation",
"type": [
"string",
"null"
]
},
"replacedAt": {
"description": "When a later stage replaces it on the authority page",
"type": [
"string",
"null"
]
},
"source": {
"description": "Source of a stage published outside the authority page",
"type": [
"string",
"null"
]
},
"stage": {
"description": "Count stage id",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"type": "array"
},
"status": {
"description": "Race status",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stale": {
"description": "Not re-verified recently, or a stage is overdue",
"type": "boolean"
},
"stale_reason": {
"description": "Why it is stale",
"type": [
"string",
"null"
]
},
"status": {
"description": "Where the election is now: scheduled, counting, finalising, final-expected, ...",
"type": "string"
},
"subdivision": {
"description": "ISO 3166-2 code of the state or region, if the election belongs to one",
"type": [
"string",
"null"
]
},
"subdivision_name": {
"description": "Name of that state or region",
"type": [
"string",
"null"
]
},
"timezone": {
"description": "IANA time zone",
"type": "string"
},
"url": {
"description": "Page on electionindex.org",
"type": "string"
}
},
"required": [
"id",
"country",
"date",
"status",
"url"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "The next elections in one country, however far ahead: polling day and whether it is declared, still tentative, or only expected within a period, what is elected, the counting authority, and when results are expected. Answers \"When is the next election in Austria?\" or \"When are the US midterms?\". National elections by default; level \"regional\" answers \"When are the next state elections in Germany?\". Covers 411 elections in 100 countries, 2021–2030, including 23 of the 27 EU member states, the 2026 US midterms in all 50 states and the certified 2024 US presidential result, with vote counts, in all 50 states and DC.",
"inputSchema": {
"properties": {
"count": {
"description": "How many upcoming elections to return, soonest first; default 3",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"country": {
"description": "Country name or ISO 3166-1 alpha-2 code, e.g. \"Austria\" or \"AT\", \"United States\" or \"US\"",
"type": "string"
},
"level": {
"description": "national: the country votes; regional: a state, region or autonomous community elects its own parliament or head (German Länder, Spanish autonomous communities, Italian regions). Default national; the answer also counts upcoming regional elections",
"enum": [
"national",
"regional",
"all"
],
"type": "string"
}
},
"required": [
"country"
],
"type": "object"
},
"name": "next_election",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"country": {
"description": "ISO code",
"type": "string"
},
"country_name": {
"description": "Country name",
"type": "string"
},
"elections": {
"items": {
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2",
"type": "string"
},
"country_name": {
"description": "Country name",
"type": "string"
},
"date": {
"description": "Polling day (YYYY-MM-DD); for an expected date, the last day of date_window",
"type": "string"
},
"date_status": {
"description": "declared, tentative, or expected (no day set yet: see date_window)",
"type": "string"
},
"date_window": {
"description": "Only for date_status \"expected\": the period polling day is expected in",
"properties": {
"from": {
"description": "First possible day (YYYY-MM-DD)",
"type": "string"
},
"label": {
"description": "How we name the period, e.g. \"Q2 2029\"",
"type": [
"string",
"null"
]
},
"to": {
"description": "Last possible day (YYYY-MM-DD)",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"id": {
"description": "Election id",
"type": "string"
},
"kind": {
"description": "Kind of election",
"type": "string"
},
"last_verified_at": {
"description": "When the record was last checked against its sources",
"type": "string"
},
"level": {
"description": "national or regional",
"type": "string"
},
"races": {
"items": {
"properties": {
"expected_stage_now": {
"description": "Count stage expected on the authority page now",
"type": [
"string",
"null"
]
},
"id": {
"description": "Race id",
"type": "string"
},
"name": {
"description": "Race name",
"type": "string"
},
"results": {
"description": "Published counts we hold, oldest first (empty until a count is recorded)",
"items": {
"properties": {
"electorate": {
"description": "Registered voters",
"type": [
"integer",
"null"
]
},
"licence": {
"description": "Licence of the numbers",
"type": "string"
},
"published_at": {
"description": "When the publisher released it",
"type": [
"string",
"null"
]
},
"publisher": {
"description": "Who published the count",
"type": "string"
},
"rows": {
"items": {
"properties": {
"candidate": {
"description": "Candidate or list",
"type": "string"
},
"colour": {
"description": "Party colour (#RRGGBB, from Wikidata)",
"type": [
"string",
"null"
]
},
"party": {
"description": "Party, where recorded",
"type": [
"string",
"null"
]
},
"party_id": {
"description": "Wikidata QID of the party",
"type": [
"string",
"null"
]
},
"seats": {
"description": "Seats or electoral votes won",
"type": [
"integer",
"null"
]
},
"share": {
"description": "Percent of total votes",
"type": [
"number",
"null"
]
},
"votes": {
"description": "Votes",
"type": "integer"
},
"winner": {
"description": "Most votes in this count",
"type": "boolean"
}
},
"type": "object"
},
"type": "array"
},
"source": {
"description": "File or page the numbers were copied from",
"type": "string"
},
"stage": {
"description": "Count stage of this version, e.g. final-result",
"type": "string"
},
"total_votes": {
"description": "Total votes cast in the race",
"type": "integer"
},
"turnout": {
"description": "Percent of registered voters who cast a ballot",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"properties": {
"check": {
"description": "Latest link check",
"type": [
"object",
"null"
]
},
"kind": {
"description": "race_results, feed, results_index, emb_home, directory or media",
"type": "string"
},
"kindReason": {
"description": "Why it was classified that way",
"type": "string"
},
"origin": {
"description": "race, stage or authority",
"type": "string"
},
"resolvable": {
"description": "Can this page answer a results question?",
"type": "boolean"
},
"role": {
"description": "What the page is for",
"type": "string"
},
"url": {
"description": "Source URL",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stages": {
"items": {
"description": "Expected window for one count stage",
"properties": {
"by": {
"description": "Latest expected time (ISO)",
"type": [
"string",
"null"
]
},
"citation": {
"description": "Basis for the window",
"type": "string"
},
"confidence": {
"description": "announced (law or authority), precedent (last election) or estimate",
"type": "string"
},
"from": {
"description": "Earliest expected time (ISO)",
"type": [
"string",
"null"
]
},
"observedAt": {
"description": "When the authority actually published it; null until observed",
"type": [
"string",
"null"
]
},
"observedSource": {
"description": "URL that proves the observation",
"type": [
"string",
"null"
]
},
"replacedAt": {
"description": "When a later stage replaces it on the authority page",
"type": [
"string",
"null"
]
},
"source": {
"description": "Source of a stage published outside the authority page",
"type": [
"string",
"null"
]
},
"stage": {
"description": "Count stage id",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"type": "array"
},
"status": {
"description": "Race status",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stale": {
"description": "Not re-verified recently, or a stage is overdue",
"type": "boolean"
},
"stale_reason": {
"description": "Why it is stale",
"type": [
"string",
"null"
]
},
"status": {
"description": "Where the election is now: scheduled, counting, finalising, final-expected, ...",
"type": "string"
},
"subdivision": {
"description": "ISO 3166-2 code of the state or region, if the election belongs to one",
"type": [
"string",
"null"
]
},
"subdivision_name": {
"description": "Name of that state or region",
"type": [
"string",
"null"
]
},
"timezone": {
"description": "IANA time zone",
"type": "string"
},
"url": {
"description": "Page on electionindex.org",
"type": "string"
}
},
"required": [
"id",
"country",
"date",
"status",
"url"
],
"type": "object"
},
"type": "array"
},
"level": {
"description": "national, regional or all",
"type": "string"
},
"note": {
"description": "Set when nothing is listed yet",
"type": "string"
},
"regional_upcoming": {
"description": "Upcoming regional elections in this country (with level national); ask again with level \"regional\"",
"type": "integer"
},
"total_upcoming": {
"description": "All upcoming elections we list for this country at this level",
"type": "integer"
}
},
"required": [
"country",
"elections"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "Every known source URL for a race, classified (race_results, feed, results_index, emb_home, directory, media). Only race_results and feed can answer a results question; homepages never can.",
"inputSchema": {
"properties": {
"election": {
"description": "Election id, e.g. \"brazil-general-2026\"; list ids with upcoming_elections",
"type": "string"
},
"race": {
"description": "Race id, e.g. \"president\"; optional when the election has one race",
"type": "string"
},
"resolvable_only": {
"description": "Only sources that can answer a results question (race_results, feed); default false",
"type": "boolean"
}
},
"required": [
"election"
],
"type": "object"
},
"name": "resolution_sources",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"items": {
"properties": {
"check": {
"description": "Latest link check",
"type": [
"object",
"null"
]
},
"kind": {
"description": "race_results, feed, results_index, emb_home, directory or media",
"type": "string"
},
"kindReason": {
"description": "Why it was classified that way",
"type": "string"
},
"origin": {
"description": "race, stage or authority",
"type": "string"
},
"resolvable": {
"description": "Can this page answer a results question?",
"type": "boolean"
},
"role": {
"description": "What the page is for",
"type": "string"
},
"url": {
"description": "Source URL",
"type": "string"
}
},
"type": "object"
},
"type": "array"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "Report a mistake or a missing election, with a URL that proves it (ideally the official authority page). The report is public and is checked like any other claim; it never changes the data by itself. Returns the report id; follow it at https://electionindex.org/corrections.",
"inputSchema": {
"properties": {
"claim": {
"description": "What is wrong and what is right, 10 to 2000 characters",
"type": "string"
},
"election": {
"description": "Election id, if the report is about a listed election",
"type": "string"
},
"evidence": {
"description": "http(s) URL of the page that proves it",
"type": "string"
},
"race": {
"description": "Race id within that election, if the report is about one race",
"type": "string"
}
},
"required": [
"claim",
"evidence"
],
"type": "object"
},
"name": "submit_correction",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"at": {
"description": "Filed at (ISO)",
"type": "string"
},
"claim": {
"description": "The report",
"type": "string"
},
"evidence": {
"description": "Evidence URL",
"type": "string"
},
"id": {
"description": "Report id",
"type": "string"
},
"status": {
"description": "open until checked",
"type": "string"
},
"url": {
"description": "Where to follow the report",
"type": "string"
}
},
"required": [
"id",
"status",
"url"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "List elections by date range and/or country, soonest first, with each race's expected count stage right now. Answers \"Which elections are in Europe this autumn?\", \"Which elections are this month?\" or \"What elections does Germany have coming up?\". Without dates it starts today; with a country and no end date it covers every future election of that country, otherwise the next 365 days. Covers 411 elections in 100 countries, 2021–2030, including 23 of the 27 EU member states, the 2026 US midterms in all 50 states and the certified 2024 US presidential result, with vote counts, in all 50 states and DC.",
"inputSchema": {
"properties": {
"country": {
"description": "Country name or ISO 3166-1 alpha-2 code, e.g. \"Austria\" or \"AT\", \"United States\" or \"US\"",
"type": "string"
},
"from": {
"description": "Start date YYYY-MM-DD; default today",
"type": "string"
},
"include_discovered": {
"description": "Also list elections found on Wikidata but not yet verified by Global Election Index",
"type": "boolean"
},
"level": {
"description": "national: the country votes; regional: a state, region or autonomous community elects its own parliament or head (German Länder, Spanish autonomous communities, Italian regions). Default all",
"enum": [
"national",
"regional",
"all"
],
"type": "string"
},
"limit": {
"description": "Most elections to return, soonest first; default 25, max 200. Narrow with from/to or country for more.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"to": {
"description": "End date YYYY-MM-DD; default +365 days, or no end when a country is given",
"type": "string"
}
},
"type": "object"
},
"name": "upcoming_elections",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"discovered_unverified": {
"description": "Found on Wikidata, not verified",
"items": {
"type": "object"
},
"type": "array"
},
"elections": {
"items": {
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2",
"type": "string"
},
"country_name": {
"description": "Country name",
"type": "string"
},
"date": {
"description": "Polling day (YYYY-MM-DD); for an expected date, the last day of date_window",
"type": "string"
},
"date_status": {
"description": "declared, tentative, or expected (no day set yet: see date_window)",
"type": "string"
},
"date_window": {
"description": "Only for date_status \"expected\": the period polling day is expected in",
"properties": {
"from": {
"description": "First possible day (YYYY-MM-DD)",
"type": "string"
},
"label": {
"description": "How we name the period, e.g. \"Q2 2029\"",
"type": [
"string",
"null"
]
},
"to": {
"description": "Last possible day (YYYY-MM-DD)",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"id": {
"description": "Election id",
"type": "string"
},
"kind": {
"description": "Kind of election",
"type": "string"
},
"last_verified_at": {
"description": "When the record was last checked against its sources",
"type": "string"
},
"level": {
"description": "national or regional",
"type": "string"
},
"races": {
"items": {
"properties": {
"expected_stage_now": {
"description": "Count stage expected on the authority page now",
"type": [
"string",
"null"
]
},
"id": {
"description": "Race id",
"type": "string"
},
"name": {
"description": "Race name",
"type": "string"
},
"results": {
"description": "Published counts we hold, oldest first (empty until a count is recorded)",
"items": {
"properties": {
"electorate": {
"description": "Registered voters",
"type": [
"integer",
"null"
]
},
"licence": {
"description": "Licence of the numbers",
"type": "string"
},
"published_at": {
"description": "When the publisher released it",
"type": [
"string",
"null"
]
},
"publisher": {
"description": "Who published the count",
"type": "string"
},
"rows": {
"items": {
"properties": {
"candidate": {
"description": "Candidate or list",
"type": "string"
},
"colour": {
"description": "Party colour (#RRGGBB, from Wikidata)",
"type": [
"string",
"null"
]
},
"party": {
"description": "Party, where recorded",
"type": [
"string",
"null"
]
},
"party_id": {
"description": "Wikidata QID of the party",
"type": [
"string",
"null"
]
},
"seats": {
"description": "Seats or electoral votes won",
"type": [
"integer",
"null"
]
},
"share": {
"description": "Percent of total votes",
"type": [
"number",
"null"
]
},
"votes": {
"description": "Votes",
"type": "integer"
},
"winner": {
"description": "Most votes in this count",
"type": "boolean"
}
},
"type": "object"
},
"type": "array"
},
"source": {
"description": "File or page the numbers were copied from",
"type": "string"
},
"stage": {
"description": "Count stage of this version, e.g. final-result",
"type": "string"
},
"total_votes": {
"description": "Total votes cast in the race",
"type": "integer"
},
"turnout": {
"description": "Percent of registered voters who cast a ballot",
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"sources": {
"items": {
"properties": {
"check": {
"description": "Latest link check",
"type": [
"object",
"null"
]
},
"kind": {
"description": "race_results, feed, results_index, emb_home, directory or media",
"type": "string"
},
"kindReason": {
"description": "Why it was classified that way",
"type": "string"
},
"origin": {
"description": "race, stage or authority",
"type": "string"
},
"resolvable": {
"description": "Can this page answer a results question?",
"type": "boolean"
},
"role": {
"description": "What the page is for",
"type": "string"
},
"url": {
"description": "Source URL",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stages": {
"items": {
"description": "Expected window for one count stage",
"properties": {
"by": {
"description": "Latest expected time (ISO)",
"type": [
"string",
"null"
]
},
"citation": {
"description": "Basis for the window",
"type": "string"
},
"confidence": {
"description": "announced (law or authority), precedent (last election) or estimate",
"type": "string"
},
"from": {
"description": "Earliest expected time (ISO)",
"type": [
"string",
"null"
]
},
"observedAt": {
"description": "When the authority actually published it; null until observed",
"type": [
"string",
"null"
]
},
"observedSource": {
"description": "URL that proves the observation",
"type": [
"string",
"null"
]
},
"replacedAt": {
"description": "When a later stage replaces it on the authority page",
"type": [
"string",
"null"
]
},
"source": {
"description": "Source of a stage published outside the authority page",
"type": [
"string",
"null"
]
},
"stage": {
"description": "Count stage id",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"type": "array"
},
"status": {
"description": "Race status",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"stale": {
"description": "Not re-verified recently, or a stage is overdue",
"type": "boolean"
},
"stale_reason": {
"description": "Why it is stale",
"type": [
"string",
"null"
]
},
"status": {
"description": "Where the election is now: scheduled, counting, finalising, final-expected, ...",
"type": "string"
},
"subdivision": {
"description": "ISO 3166-2 code of the state or region, if the election belongs to one",
"type": [
"string",
"null"
]
},
"subdivision_name": {
"description": "Name of that state or region",
"type": [
"string",
"null"
]
},
"timezone": {
"description": "IANA time zone",
"type": "string"
},
"url": {
"description": "Page on electionindex.org",
"type": "string"
}
},
"required": [
"id",
"country",
"date",
"status",
"url"
],
"type": "object"
},
"type": "array"
},
"returned": {
"description": "Elections in this answer (see limit)",
"type": "integer"
},
"total": {
"description": "Elections matching the filters",
"type": "integer"
}
},
"required": [
"elections"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
},
{
"description": "When will a race's final (certified) result exist? Returns the expected window, its confidence (announced / precedent / estimate) and basis, how many days the final took last time, and the final count itself once we hold it. Use this before asking or settling any \"final result\" question.",
"inputSchema": {
"properties": {
"election": {
"description": "Election id, e.g. \"brazil-general-2026\"; list ids with upcoming_elections",
"type": "string"
},
"race": {
"description": "Race id, e.g. \"president\"; optional when the election has one race",
"type": "string"
}
},
"required": [
"election"
],
"type": "object"
},
"name": "when_final",
"outputSchema": {
"properties": {
"meta": {
"description": "What this answer was built from; cite dataset_version",
"properties": {
"built_at": {
"description": "When the dataset was built",
"type": "string"
},
"dataset_version": {
"description": "Dataset version",
"type": "string"
},
"docs": {
"description": "Documentation URL",
"type": "string"
},
"generated_at": {
"description": "When this answer was generated",
"type": "string"
},
"licence": {
"description": "Licence and required credit",
"type": "string"
}
},
"required": [
"dataset_version",
"licence"
],
"type": "object"
},
"result": {
"properties": {
"basis": {
"description": "Legal or historical basis",
"type": "string"
},
"confidence": {
"description": "announced, precedent or estimate",
"type": [
"string",
"null"
]
},
"election": {
"description": "Election id",
"type": "string"
},
"final_expected_by": {
"description": "Latest expected time of the final result",
"type": [
"string",
"null"
]
},
"final_expected_from": {
"description": "Earliest expected time of the final result",
"type": [
"string",
"null"
]
},
"final_result": {
"description": "The final count, when we hold it",
"properties": {
"electorate": {
"description": "Registered voters",
"type": [
"integer",
"null"
]
},
"licence": {
"description": "Licence of the numbers",
"type": "string"
},
"published_at": {
"description": "When the publisher released it",
"type": [
"string",
"null"
]
},
"publisher": {
"description": "Who published the count",
"type": "string"
},
"rows": {
"items": {
"properties": {
"candidate": {
"description": "Candidate or list",
"type": "string"
},
"colour": {
"description": "Party colour (#RRGGBB, from Wikidata)",
"type": [
"string",
"null"
]
},
"party": {
"description": "Party, where recorded",
"type": [
"string",
"null"
]
},
"party_id": {
"description": "Wikidata QID of the party",
"type": [
"string",
"null"
]
},
"seats": {
"description": "Seats or electoral votes won",
"type": [
"integer",
"null"
]
},
"share": {
"description": "Percent of total votes",
"type": [
"number",
"null"
]
},
"votes": {
"description": "Votes",
"type": "integer"
},
"winner": {
"description": "Most votes in this count",
"type": "boolean"
}
},
"type": "object"
},
"type": "array"
},
"source": {
"description": "File or page the numbers were copied from",
"type": "string"
},
"stage": {
"description": "Count stage of this version, e.g. final-result",
"type": "string"
},
"total_votes": {
"description": "Total votes cast in the race",
"type": "integer"
},
"turnout": {
"description": "Percent of registered voters who cast a ballot",
"type": [
"number",
"null"
]
}
},
"type": [
"object",
"null"
]
},
"last_time": {
"description": "How long the final result took the last time this kind of race was held here",
"properties": {
"act": {
"description": "What the final act was",
"type": [
"string",
"null"
]
},
"days": {
"description": "Days from polling day to the final act",
"type": "integer"
},
"election": {
"description": "That election, e.g. \"Bundestag 2025\"",
"type": "string"
},
"final_on": {
"description": "Day of its official final act",
"type": "string"
},
"polling_day": {
"description": "Its polling day",
"type": "string"
},
"source": {
"description": "Page showing the date",
"type": [
"string",
"null"
]
},
"source_kind": {
"description": "authority or press",
"type": "string"
}
},
"type": [
"object",
"null"
]
},
"observed": {
"description": "True once the authority has published the final result",
"type": "boolean"
},
"race": {
"description": "Race id",
"type": "string"
}
},
"required": [
"election",
"race",
"observed"
],
"type": "object"
}
},
"required": [
"result",
"meta"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e2258b1a20025b74f74556c970c20dc7db5efa29a57807053832ccd3de09c847 | sha256sum