Election Index

{'type': 'object', 'required': ['election'], 'properties': {'race': {'type': 'string', 'description': 'Race id, e.g. "president"; optional when the election has one race'}, 'stage': {'enum': ['exit-poll', 'election-night', 'media-call', 'intermediate-count', 'final-result', 'court-validation', 'government'], 'type': 'string', 'description': 'Default final-result'}, 'ask_at': {'type': 'string', 'description': 'ISO date-time; default now'}, 'election': {'type': 'string', 'description': 'Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['election', 'race', 'verdict'], 'properties': {'race': {'type': 'string', 'description': 'Race id'}, 'stage': {'type': 'string', 'description': 'Count stage asked about'}, 'ask_at': {'type': 'string', 'description': 'Time the question would be asked (ISO)'}, 'detail': {'type': 'string', 'description': 'Explanation'}, 'window': {'type': ['object', 'null'], 'properties': {'by': {'type': ['string', 'null'], 'description': 'Latest expected time (ISO)'}, 'from': {'type': ['string', 'null'], 'description': 'Earliest expected time (ISO)'}, 'stage': {'type': 'string', 'description': 'Count stage id'}, 'source': {'type': ['string', 'null'], 'description': 'Source of a stage published outside the authority page'}, 'citation': {'type': 'string', 'description': 'Basis for the window'}, 'confidence': {'type': 'string', 'description': 'announced (law or authority), precedent (last election) or estimate'}, 'observedAt': {'type': ['string', 'null'], 'description': 'When the authority actually published it; null until observed'}, 'replacedAt': {'type': ['string', 'null'], 'description': 'When a later stage replaces it on the authority page'}, 'observedSource': {'type': ['string', 'null'], 'description': 'URL that proves the observation'}}, 'description': 'Expected window for one count stage'}, 'verdict': {'type': 'string', 'description': 'ok, too-early, inside-window, too-late or no-window'}, 'election': {'type': 'string', 'description': 'Election id'}, 'replaced_at': {'type': ['string', 'null'], 'description': 'When a later stage replaces this one'}, 'settle_after': {'type': ['string', 'null'], 'description': 'Earliest time the question can be settled'}, 'resolution_sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Source URL'}, 'kind': {'type': 'string', 'description': 'race_results, feed, results_index, emb_home, directory or media'}, 'role': {'type': 'string', 'description': 'What the page is for'}, 'check': {'type': ['object', 'null'], 'description': 'Latest link check'}, 'origin': {'type': 'string', 'description': 'race, stage or authority'}, 'kindReason': {'type': 'string', 'description': 'Why it was classified that way'}, 'resolvable': {'type': 'boolean', 'description': 'Can this page answer a results question?'}}}}}}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['elections', 'races'], 'properties': {'races': {'type': 'integer', 'description': 'Races'}, 'stale': {'type': 'array', 'items': {'type': 'object'}, 'description': 'First 20 stale records'}, 'warnings': {'type': 'array', 'items': {'type': 'object'}, 'description': 'First 20 publisher-gate warnings'}, 'elections': {'type': 'integer', 'description': 'Profiled elections'}, 'authorities': {'type': 'integer', 'description': 'Counting authorities'}, 'full_report': {'type': 'string', 'description': 'URL of the full report with every warning'}, 'stale_total': {'type': 'integer', 'description': 'All stale records'}, 'links_checked': {'type': 'integer', 'description': 'Links checked by the Auditor'}, 'races_without': {'type': 'array', 'items': {'type': 'string'}, 'description': 'First 20 races lacking one'}, 'warnings_total': {'type': 'integer', 'description': 'All publisher-gate warnings'}, 'warnings_by_level': {'type': 'object', 'description': 'Warning count per level'}, 'races_without_total': {'type': 'integer', 'description': 'All races lacking one'}, 'discovered_unprofiled': {'type': 'integer', 'description': 'Found, not yet profiled'}, 'races_with_resolvable_results_source': {'type': 'integer', 'description': 'Races with a page that can answer a results question'}}}}}

{'type': 'object', 'required': ['election'], 'properties': {'election': {'type': 'string', 'description': 'Election id, e.g. "latvia-parliamentary-2026"'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['id', 'country', 'date', 'status', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Election id'}, 'url': {'type': 'string', 'description': 'Page on electionindex.org'}, 'date': {'type': 'string', 'description': 'Polling day (YYYY-MM-DD)'}, 'kind': {'type': 'string', 'description': 'Kind of election'}, 'level': {'type': 'string', 'description': 'national or regional'}, 'races': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Race id'}, 'name': {'type': 'string', 'description': 'Race name'}, 'stages': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'by': {'type': ['string', 'null'], 'description': 'Latest expected time (ISO)'}, 'from': {'type': ['string', 'null'], 'description': 'Earliest expected time (ISO)'}, 'stage': {'type': 'string', 'description': 'Count stage id'}, 'source': {'type': ['string', 'null'], 'description': 'Source of a stage published outside the authority page'}, 'citation': {'type': 'string', 'description': 'Basis for the window'}, 'confidence': {'type': 'string', 'description': 'announced (law or authority), precedent (last election) or estimate'}, 'observedAt': {'type': ['string', 'null'], 'description': 'When the authority actually published it; null until observed'}, 'replacedAt': {'type': ['string', 'null'], 'description': 'When a later stage replaces it on the authority page'}, 'observedSource': {'type': ['string', 'null'], 'description': 'URL that proves the observation'}}, 'description': 'Expected window for one count stage'}}, 'status': {'type': 'string', 'description': 'Race status'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'party': {'type': ['string', 'null'], 'description': 'Party, where recorded'}, 'seats': {'type': ['integer', 'null'], 'description': 'Seats or electoral votes won'}, 'share': {'type': ['number', 'null'], 'description': 'Percent of total votes'}, 'votes': {'type': 'integer', 'description': 'Votes'}, 'colour': {'type': ['string', 'null'], 'description': 'Party colour (#RRGGBB, from Wikidata)'}, 'winner': {'type': 'boolean', 'description': 'Most votes in this count'}, 'party_id': {'type': ['string', 'null'], 'description': 'Wikidata QID of the party'}, 'candidate': {'type': 'string', 'description': 'Candidate or list'}}}}, 'stage': {'type': 'string', 'description': 'Count stage of this version, e.g. final-result'}, 'source': {'type': 'string', 'description': 'File or page the numbers were copied from'}, 'licence': {'type': 'string', 'description': 'Licence of the numbers'}, 'turnout': {'type': ['number', 'null'], 'description': 'Percent of registered voters who cast a ballot'}, 'publisher': {'type': 'string', 'description': 'Who published the count'}, 'electorate': {'type': ['integer', 'null'], 'description': 'Registered voters'}, 'total_votes': {'type': 'integer', 'description': 'Total votes cast in the race'}, 'published_at': {'type': ['string', 'null'], 'description': 'When the publisher released it'}}}, 'description': 'Published counts we hold, oldest first (empty until a count is recorded)'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Source URL'}, 'kind': {'type': 'string', 'description': 'race_results, feed, results_index, emb_home, directory or media'}, 'role': {'type': 'string', 'description': 'What the page is for'}, 'check': {'type': ['object', 'null'], 'description': 'Latest link check'}, 'origin': {'type': 'string', 'description': 'race, stage or authority'}, 'kindReason': {'type': 'string', 'description': 'Why it was classified that way'}, 'resolvable': {'type': 'boolean', 'description': 'Can this page answer a results question?'}}}}, 'expected_stage_now': {'type': ['string', 'null'], 'description': 'Count stage expected on the authority page now'}}}}, 'stale': {'type': 'boolean', 'description': 'Not re-verified recently, or a stage is overdue'}, 'status': {'type': 'string', 'description': 'Where the election is now: scheduled, counting, finalising, final-expected, ...'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2'}, 'timezone': {'type': 'string', 'description': 'IANA time zone'}, 'date_status': {'type': 'string', 'description': 'declared, scheduled or tentative'}, 'subdivision': {'type': ['string', 'null'], 'description': 'ISO 3166-2 code of the state or region, if the election belongs to one'}, 'country_name': {'type': 'string', 'description': 'Country name'}, 'stale_reason': {'type': ['string', 'null'], 'description': 'Why it is stale'}, 'last_verified_at': {'type': 'string', 'description': 'When the record was last checked against its sources'}, 'subdivision_name': {'type': ['string', 'null'], 'description': 'Name of that state or region'}}}}}

{'type': 'object', 'required': ['country'], 'properties': {'count': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many upcoming elections to return, soonest first; default 3'}, 'level': {'enum': ['national', 'regional', 'all'], 'type': 'string', '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'}, 'country': {'type': 'string', 'description': 'Country name or ISO 3166-1 alpha-2 code, e.g. "Austria" or "AT", "United States" or "US"'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['country', 'elections'], 'properties': {'note': {'type': 'string', 'description': 'Set when nothing is listed yet'}, 'level': {'type': 'string', 'description': 'national, regional or all'}, 'country': {'type': 'string', 'description': 'ISO code'}, 'elections': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'country', 'date', 'status', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Election id'}, 'url': {'type': 'string', 'description': 'Page on electionindex.org'}, 'date': {'type': 'string', 'description': 'Polling day (YYYY-MM-DD)'}, 'kind': {'type': 'string', 'description': 'Kind of election'}, 'level': {'type': 'string', 'description': 'national or regional'}, 'races': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Race id'}, 'name': {'type': 'string', 'description': 'Race name'}, 'stages': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'by': {'type': ['string', 'null'], 'description': 'Latest expected time (ISO)'}, 'from': {'type': ['string', 'null'], 'description': 'Earliest expected time (ISO)'}, 'stage': {'type': 'string', 'description': 'Count stage id'}, 'source': {'type': ['string', 'null'], 'description': 'Source of a stage published outside the authority page'}, 'citation': {'type': 'string', 'description': 'Basis for the window'}, 'confidence': {'type': 'string', 'description': 'announced (law or authority), precedent (last election) or estimate'}, 'observedAt': {'type': ['string', 'null'], 'description': 'When the authority actually published it; null until observed'}, 'replacedAt': {'type': ['string', 'null'], 'description': 'When a later stage replaces it on the authority page'}, 'observedSource': {'type': ['string', 'null'], 'description': 'URL that proves the observation'}}, 'description': 'Expected window for one count stage'}}, 'status': {'type': 'string', 'description': 'Race status'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'party': {'type': ['string', 'null'], 'description': 'Party, where recorded'}, 'seats': {'type': ['integer', 'null'], 'description': 'Seats or electoral votes won'}, 'share': {'type': ['number', 'null'], 'description': 'Percent of total votes'}, 'votes': {'type': 'integer', 'description': 'Votes'}, 'colour': {'type': ['string', 'null'], 'description': 'Party colour (#RRGGBB, from Wikidata)'}, 'winner': {'type': 'boolean', 'description': 'Most votes in this count'}, 'party_id': {'type': ['string', 'null'], 'description': 'Wikidata QID of the party'}, 'candidate': {'type': 'string', 'description': 'Candidate or list'}}}}, 'stage': {'type': 'string', 'description': 'Count stage of this version, e.g. final-result'}, 'source': {'type': 'string', 'description': 'File or page the numbers were copied from'}, 'licence': {'type': 'string', 'description': 'Licence of the numbers'}, 'turnout': {'type': ['number', 'null'], 'description': 'Percent of registered voters who cast a ballot'}, 'publisher': {'type': 'string', 'description': 'Who published the count'}, 'electorate': {'type': ['integer', 'null'], 'description': 'Registered voters'}, 'total_votes': {'type': 'integer', 'description': 'Total votes cast in the race'}, 'published_at': {'type': ['string', 'null'], 'description': 'When the publisher released it'}}}, 'description': 'Published counts we hold, oldest first (empty until a count is recorded)'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Source URL'}, 'kind': {'type': 'string', 'description': 'race_results, feed, results_index, emb_home, directory or media'}, 'role': {'type': 'string', 'description': 'What the page is for'}, 'check': {'type': ['object', 'null'], 'description': 'Latest link check'}, 'origin': {'type': 'string', 'description': 'race, stage or authority'}, 'kindReason': {'type': 'string', 'description': 'Why it was classified that way'}, 'resolvable': {'type': 'boolean', 'description': 'Can this page answer a results question?'}}}}, 'expected_stage_now': {'type': ['string', 'null'], 'description': 'Count stage expected on the authority page now'}}}}, 'stale': {'type': 'boolean', 'description': 'Not re-verified recently, or a stage is overdue'}, 'status': {'type': 'string', 'description': 'Where the election is now: scheduled, counting, finalising, final-expected, ...'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2'}, 'timezone': {'type': 'string', 'description': 'IANA time zone'}, 'date_status': {'type': 'string', 'description': 'declared, scheduled or tentative'}, 'subdivision': {'type': ['string', 'null'], 'description': 'ISO 3166-2 code of the state or region, if the election belongs to one'}, 'country_name': {'type': 'string', 'description': 'Country name'}, 'stale_reason': {'type': ['string', 'null'], 'description': 'Why it is stale'}, 'last_verified_at': {'type': 'string', 'description': 'When the record was last checked against its sources'}, 'subdivision_name': {'type': ['string', 'null'], 'description': 'Name of that state or region'}}}}, 'country_name': {'type': 'string', 'description': 'Country name'}, 'total_upcoming': {'type': 'integer', 'description': 'All upcoming elections we list for this country at this level'}, 'regional_upcoming': {'type': 'integer', 'description': 'Upcoming regional elections in this country (with level national); ask again with level "regional"'}}}}}

{'type': 'object', 'required': ['election'], 'properties': {'race': {'type': 'string', 'description': 'Race id, e.g. "president"; optional when the election has one race'}, 'election': {'type': 'string', 'description': 'Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections'}, 'resolvable_only': {'type': 'boolean', 'description': 'Only sources that can answer a results question (race_results, feed); default false'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Source URL'}, 'kind': {'type': 'string', 'description': 'race_results, feed, results_index, emb_home, directory or media'}, 'role': {'type': 'string', 'description': 'What the page is for'}, 'check': {'type': ['object', 'null'], 'description': 'Latest link check'}, 'origin': {'type': 'string', 'description': 'race, stage or authority'}, 'kindReason': {'type': 'string', 'description': 'Why it was classified that way'}, 'resolvable': {'type': 'boolean', 'description': 'Can this page answer a results question?'}}}}}}

{'type': 'object', 'required': ['claim', 'evidence'], 'properties': {'race': {'type': 'string', 'description': 'Race id within that election, if the report is about one race'}, 'claim': {'type': 'string', 'description': 'What is wrong and what is right, 10 to 2000 characters'}, 'election': {'type': 'string', 'description': 'Election id, if the report is about a listed election'}, 'evidence': {'type': 'string', 'description': 'http(s) URL of the page that proves it'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['id', 'status', 'url'], 'properties': {'at': {'type': 'string', 'description': 'Filed at (ISO)'}, 'id': {'type': 'string', 'description': 'Report id'}, 'url': {'type': 'string', 'description': 'Where to follow the report'}, 'claim': {'type': 'string', 'description': 'The report'}, 'status': {'type': 'string', 'description': 'open until checked'}, 'evidence': {'type': 'string', 'description': 'Evidence URL'}}}}}

{'type': 'object', 'properties': {'to': {'type': 'string', 'description': 'End date YYYY-MM-DD; default +365 days, or no end when a country is given'}, 'from': {'type': 'string', 'description': 'Start date YYYY-MM-DD; default today'}, 'level': {'enum': ['national', 'regional', 'all'], 'type': 'string', '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'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Most elections to return, soonest first; default 25, max 200. Narrow with from/to or country for more.'}, 'country': {'type': 'string', 'description': 'Country name or ISO 3166-1 alpha-2 code, e.g. "Austria" or "AT", "United States" or "US"'}, 'include_discovered': {'type': 'boolean', 'description': 'Also list elections found on Wikidata but not yet verified by Election Index'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['elections'], 'properties': {'total': {'type': 'integer', 'description': 'Elections matching the filters'}, 'returned': {'type': 'integer', 'description': 'Elections in this answer (see limit)'}, 'elections': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'country', 'date', 'status', 'url'], 'properties': {'id': {'type': 'string', 'description': 'Election id'}, 'url': {'type': 'string', 'description': 'Page on electionindex.org'}, 'date': {'type': 'string', 'description': 'Polling day (YYYY-MM-DD)'}, 'kind': {'type': 'string', 'description': 'Kind of election'}, 'level': {'type': 'string', 'description': 'national or regional'}, 'races': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Race id'}, 'name': {'type': 'string', 'description': 'Race name'}, 'stages': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'by': {'type': ['string', 'null'], 'description': 'Latest expected time (ISO)'}, 'from': {'type': ['string', 'null'], 'description': 'Earliest expected time (ISO)'}, 'stage': {'type': 'string', 'description': 'Count stage id'}, 'source': {'type': ['string', 'null'], 'description': 'Source of a stage published outside the authority page'}, 'citation': {'type': 'string', 'description': 'Basis for the window'}, 'confidence': {'type': 'string', 'description': 'announced (law or authority), precedent (last election) or estimate'}, 'observedAt': {'type': ['string', 'null'], 'description': 'When the authority actually published it; null until observed'}, 'replacedAt': {'type': ['string', 'null'], 'description': 'When a later stage replaces it on the authority page'}, 'observedSource': {'type': ['string', 'null'], 'description': 'URL that proves the observation'}}, 'description': 'Expected window for one count stage'}}, 'status': {'type': 'string', 'description': 'Race status'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'party': {'type': ['string', 'null'], 'description': 'Party, where recorded'}, 'seats': {'type': ['integer', 'null'], 'description': 'Seats or electoral votes won'}, 'share': {'type': ['number', 'null'], 'description': 'Percent of total votes'}, 'votes': {'type': 'integer', 'description': 'Votes'}, 'colour': {'type': ['string', 'null'], 'description': 'Party colour (#RRGGBB, from Wikidata)'}, 'winner': {'type': 'boolean', 'description': 'Most votes in this count'}, 'party_id': {'type': ['string', 'null'], 'description': 'Wikidata QID of the party'}, 'candidate': {'type': 'string', 'description': 'Candidate or list'}}}}, 'stage': {'type': 'string', 'description': 'Count stage of this version, e.g. final-result'}, 'source': {'type': 'string', 'description': 'File or page the numbers were copied from'}, 'licence': {'type': 'string', 'description': 'Licence of the numbers'}, 'turnout': {'type': ['number', 'null'], 'description': 'Percent of registered voters who cast a ballot'}, 'publisher': {'type': 'string', 'description': 'Who published the count'}, 'electorate': {'type': ['integer', 'null'], 'description': 'Registered voters'}, 'total_votes': {'type': 'integer', 'description': 'Total votes cast in the race'}, 'published_at': {'type': ['string', 'null'], 'description': 'When the publisher released it'}}}, 'description': 'Published counts we hold, oldest first (empty until a count is recorded)'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Source URL'}, 'kind': {'type': 'string', 'description': 'race_results, feed, results_index, emb_home, directory or media'}, 'role': {'type': 'string', 'description': 'What the page is for'}, 'check': {'type': ['object', 'null'], 'description': 'Latest link check'}, 'origin': {'type': 'string', 'description': 'race, stage or authority'}, 'kindReason': {'type': 'string', 'description': 'Why it was classified that way'}, 'resolvable': {'type': 'boolean', 'description': 'Can this page answer a results question?'}}}}, 'expected_stage_now': {'type': ['string', 'null'], 'description': 'Count stage expected on the authority page now'}}}}, 'stale': {'type': 'boolean', 'description': 'Not re-verified recently, or a stage is overdue'}, 'status': {'type': 'string', 'description': 'Where the election is now: scheduled, counting, finalising, final-expected, ...'}, 'country': {'type': 'string', 'description': 'ISO 3166-1 alpha-2'}, 'timezone': {'type': 'string', 'description': 'IANA time zone'}, 'date_status': {'type': 'string', 'description': 'declared, scheduled or tentative'}, 'subdivision': {'type': ['string', 'null'], 'description': 'ISO 3166-2 code of the state or region, if the election belongs to one'}, 'country_name': {'type': 'string', 'description': 'Country name'}, 'stale_reason': {'type': ['string', 'null'], 'description': 'Why it is stale'}, 'last_verified_at': {'type': 'string', 'description': 'When the record was last checked against its sources'}, 'subdivision_name': {'type': ['string', 'null'], 'description': 'Name of that state or region'}}}}, 'discovered_unverified': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Found on Wikidata, not verified'}}}}}

{'type': 'object', 'required': ['election'], 'properties': {'race': {'type': 'string', 'description': 'Race id, e.g. "president"; optional when the election has one race'}, 'election': {'type': 'string', 'description': 'Election id, e.g. "brazil-general-2026"; list ids with upcoming_elections'}}}

{'type': 'object', 'required': ['result', 'meta'], 'properties': {'meta': {'type': 'object', 'required': ['dataset_version', 'licence'], 'properties': {'docs': {'type': 'string', 'description': 'Documentation URL'}, 'licence': {'type': 'string', 'description': 'Licence and required credit'}, 'built_at': {'type': 'string', 'description': 'When the dataset was built'}, 'generated_at': {'type': 'string', 'description': 'When this answer was generated'}, 'dataset_version': {'type': 'string', 'description': 'Dataset version'}}, 'description': 'What this answer was built from; cite dataset_version'}, 'result': {'type': 'object', 'required': ['election', 'race', 'observed'], 'properties': {'race': {'type': 'string', 'description': 'Race id'}, 'basis': {'type': 'string', 'description': 'Legal or historical basis'}, 'election': {'type': 'string', 'description': 'Election id'}, 'observed': {'type': 'boolean', 'description': 'True once the authority has published the final result'}, 'last_time': {'type': ['object', 'null'], 'properties': {'act': {'type': ['string', 'null'], 'description': 'What the final act was'}, 'days': {'type': 'integer', 'description': 'Days from polling day to the final act'}, 'source': {'type': ['string', 'null'], 'description': 'Page showing the date'}, 'election': {'type': 'string', 'description': 'That election, e.g. "Bundestag 2025"'}, 'final_on': {'type': 'string', 'description': 'Day of its official final act'}, 'polling_day': {'type': 'string', 'description': 'Its polling day'}, 'source_kind': {'type': 'string', 'description': 'authority or press'}}, 'description': 'How long the final result took the last time this kind of race was held here'}, 'confidence': {'type': ['string', 'null'], 'description': 'announced, precedent or estimate'}, 'final_result': {'type': ['object', 'null'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'properties': {'party': {'type': ['string', 'null'], 'description': 'Party, where recorded'}, 'seats': {'type': ['integer', 'null'], 'description': 'Seats or electoral votes won'}, 'share': {'type': ['number', 'null'], 'description': 'Percent of total votes'}, 'votes': {'type': 'integer', 'description': 'Votes'}, 'colour': {'type': ['string', 'null'], 'description': 'Party colour (#RRGGBB, from Wikidata)'}, 'winner': {'type': 'boolean', 'description': 'Most votes in this count'}, 'party_id': {'type': ['string', 'null'], 'description': 'Wikidata QID of the party'}, 'candidate': {'type': 'string', 'description': 'Candidate or list'}}}}, 'stage': {'type': 'string', 'description': 'Count stage of this version, e.g. final-result'}, 'source': {'type': 'string', 'description': 'File or page the numbers were copied from'}, 'licence': {'type': 'string', 'description': 'Licence of the numbers'}, 'turnout': {'type': ['number', 'null'], 'description': 'Percent of registered voters who cast a ballot'}, 'publisher': {'type': 'string', 'description': 'Who published the count'}, 'electorate': {'type': ['integer', 'null'], 'description': 'Registered voters'}, 'total_votes': {'type': 'integer', 'description': 'Total votes cast in the race'}, 'published_at': {'type': ['string', 'null'], 'description': 'When the publisher released it'}}, 'description': 'The final count, when we hold it'}, 'final_expected_by': {'type': ['string', 'null'], 'description': 'Latest expected time of the final result'}, 'final_expected_from': {'type': ['string', 'null'], 'description': 'Earliest expected time of the final result'}}}}}