Read parliamentary main votes
riksdag_get_votesRead authoritative report decisions and party main-vote groups separated by avser, or a member’s session main votes. Report mode requires report or documentId; ballots true with an explicit point adds individual member ballots and independent ballotPage continuation. Member mode requires memberId. Follow complete local continuation calls. Main votes do not include every ballot round; empty rows never prove acclamation.
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": {
"mode": "<mode>",
"session": "<session>"
},
"name": "riksdag_get_votes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Report decision points or one member’s session main votes. | |
| limit | No | Member or report-ballot requested rows; default 20, applied maximum 500. | |
| party | No | Member-mode local party filter; report party groups are always complete. | |
| point | No | One authoritative report point; omit to traverse all points. | |
| offset | No | Member or explicit report-ballot local row offset; default 0. | |
| report | No | Report designation or session:designation; report mode only. | |
| ballots | No | Report mode only: include individual ballots for an explicit point; default false. | |
| session | Yes | Required parliamentary session, for example 2024/25. | |
| memberId | No | Required in member mode: numeric memberId from riksdag_search_members, including leading zeros. | |
| revision | No | Returned complete-candidate or report-catalog revision for consistent continuation. | |
| documentId | No | Report mode: documentId from riksdag_search_documents with documentType bet; alternative to report. | |
| pointLimit | No | All-points report page size; default 5, applied maximum 10. | |
| pointOffset | No | All-points report local offset; default 0. | |
| ballotRevision | No | Returned ballot-page revision for consistent report-ballot continuation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Applied workflow. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | Whether the selected report or member-vote selection is available; empty member rows remain a successful selection. | |
| limit | No | Applied member row limit after fitting. | |
| party | No | Applied member-mode party filter. | |
| votes | No | Whole member or explicit report-point main ballots after local pagination. | |
| offset | No | Applied member row offset. | |
| points | No | Whole report points with every party aggregate and complete decision evidence. | |
| report | No | Normalized report designation. | |
| source | No | Required attribution to the Swedish Parliament. | |
| hasMore | No | More whole rows or report points remain. | |
| notices | No | All applicable notices, including an empty list. | |
| session | No | Normalized parliamentary session. | |
| guidance | No | How to resolve a missing report. | |
| memberId | No | Normalized member ID, preserving leading zeros. | |
| nextCall | No | Complete continuation advancing by actual returned entries. | |
| revision | No | Hash of complete normalized candidates or authoritative point catalog. | |
| truncated | No | Response fitting shortened the requested local page. | |
| ballotPage | No | Independent ballot pagination; report-point counts and revision retain their meanings. | |
| documentId | No | Authoritative report document ID. | |
| pointLimit | No | Applied report-point limit after measured fitting. | |
| totalCount | No | Exact filtered member-vote total or selected report-point total. | |
| pointOffset | No | Applied report-point offset. | |
| retrievedAt | No | Source fetch time, retained unchanged on cache hits. | |
| returnedCount | No | Actual returned whole rows or points. | |
| upstreamQuery | No | Upstream query echo; not proof that a filter was applied. | |
| candidateCount | No | Complete validated member/session candidate count, optionally narrowed upstream by party, before local filtering. | |
| effectiveQuery | No | Deterministic normalized input, applied defaults and local filters. | |
| requestedLimit | No | Original requested member row limit. | |
| pointTotalCount | No | Exact complete authoritative report-point catalog count. | |
| upstreamWarnings | No | Warnings supplied by the source. | |
| requestedPointLimit | No | Original requested report-point limit. |