Read historical House and Senate election results
get_election_resultsRetrieve source-backed U.S. House and Senate results for an explicitly requested year. The archive currently covers 2016, 2018, 2020, 2022 and 2024. Other years return an unsupported-year error, never substituted historical results. Includes votes, sources, record links and calculation caveats. Not live returns, projections or presidential results.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"year": "<year>"
},
"name": "get_election_results"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| limit | No | ||
| state | No | Two-letter state or territory code of the public records being researched, not the user's location. | |
| office | No | ||
| district | No | ||
| candidate | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| links | Yes | ||
| sources | Yes | ||
| citation | Yes | ||
| coverage | Yes |