Search Parliamentary Divisions
votes_search_divisionsRead-onlyIdempotent
Find UK Parliament vote summaries by topic, date, or member. Returns division title, date, vote counts, and pass/fail status. Combine with votes_get_division for detailed voter lists.
Instructions
USE THIS TOOL WHEN searching Commons or Lords formal votes by topic, date, or member.
Returns division summaries (title, date, vote counts, pass/fail). AFTER calling, pass division_id + house into votes_get_division for the full member-by-member voter lists.
Authoritative source for UK parliamentary vote records.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Search term for division titles, e.g. 'Rwanda' or 'Online Safety Bill'. Omit to browse recent divisions. | |
| house | No | Which house to search. | Commons |
| from_date | No | Start date (YYYY-MM-DD). | |
| to_date | No | End date (YYYY-MM-DD). | |
| member_id | No | Filter to divisions where this member voted. Get the member ID from parliament_find_member. | |
| offset | No | Number of divisions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true. | |
| limit | No | Maximum divisions to return. Default 25 (Commons API max-per-page). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | The search term, if any (None = browse recent) | |
| house | Yes | Commons or Lords | |
| offset | No | Skip applied to this page | |
| limit | No | Page size requested | |
| total | Yes | Number of divisions returned in this call | |
| has_more | No | True if a full page was returned (more may exist) | |
| divisions | No | Matching divisions. Use the integer `id` field with votes_get_division to fetch the full voter list. |