Lords Votes API
An API providing access to House of Lords voting records, published by UK Parliament. It allows querying of division (vote) data from the Lords, including how members voted on specific motions and questions. The service is freely accessible without authentication and covers the national UK legislative scope. It can be used to track voting patterns and outcomes within the House of Lords over time.An API that allows querying of Lords Votes data.
Trust score
How is this computed?Weighted across five axes. Tap a ring for what it measures.
Data schema (55 fields)
| Field | Type | Description |
|---|---|---|
| divisionIdDivision id | integer (int32) | Unique identifier of the division.Division with ID specified |
| SearchTermSearch term | string | Text used to search or filter divisions.Text used to search or filter divisions. |
| MemberIdMember id | integer (int32) | Identifier of the member to filter results by.Identifier of the member to filter results by. |
| IncludeWhenMemberWasTellerInclude when member was teller | boolean | Whether to include votes where the member acted as a teller.Whether to include votes where the member acted as a teller. |
| StartDateStart date | string (date-time) | Start of the date range to filter divisions.Start of the date range to filter divisions. |
| EndDateEnd date | string (date-time) | End of the date range to filter divisions.End of the date range to filter divisions. |
| DivisionNumberDivision number | integer (int32) | Sequential number identifying the division.Sequential number identifying the division. |
| TotalVotesCast.ComparatorTotal votes cast.comparator | string | Comparison operator applied to the total votes cast filter.Comparison operator applied to the total votes cast filter. |
| TotalVotesCast.ValueToCompareTotal votes cast.value to compare | integer (int32) | Value compared against the total number of votes cast.Value compared against the total number of votes cast. |
| Majority.Comparator | string | Comparison operator applied to the majority filter.Comparison operator applied to the majority filter. |
| Majority.ValueToCompareMajority.value to compare | integer (int32) | Value compared against the division's majority.Value compared against the division's majority. |
| skip | integer (int32) | Number of records to skip. Must be a positive integer. Default is 0.The number of records to skip. Must be a positive integer. Default is 0 |
| take | integer (int32) | Number of records to return per page. Must be more than 0. Default is 25.The number of records to return per page. Must be more than 0. Default is 25 |
| numberDivisionGroupByPartyViewModel | integer (int32) | Division number for this group-by-party result.Division number for this group-by-party result. |
| titleDivisionGroupByPartyViewModel | string | Title of the division.Title of the division. |
| dateDivisionGroupByPartyViewModel | string (date-time) | Date the division took place.Date the division took place. |
| contentCountDivisionGroupByPartyViewModel | integer (int32) | Total number of Content votes recorded.Total number of Content votes recorded. |
| notContentCountDivisionGroupByPartyViewModel | integer (int32) | Total number of Not Content votes recorded.Total number of Not Content votes recorded. |
| contentDivisionGroupByPartyViewModel | array<object> | List of members or parties who voted Content.List of members or parties who voted Content. |
| notContentDivisionGroupByPartyViewModel | array<object> | List of members or parties who voted Not Content.List of members or parties who voted Not Content. |
| notesDivisionViewModel | string | Additional notes about the division.Additional notes about the division. |
| isWhippedDivisionViewModel | boolean | Whether the division was subject to a party whip.Whether the division was subject to a party whip. |
| isGovernmentContentDivisionViewModel | boolean | Whether the government position was Content.Whether the government position was Content. |
| authoritativeContentCountDivisionViewModel | integer (int32) | Official Content count, using teller counts if tellers were present, otherwise member counts.Authoritative content count is the official count. This is the teller content count when tellers are present, but member content count when there are no tellers. |
| authoritativeNotContentCountDivisionViewModel | integer (int32) | Official Not Content count, using teller counts if tellers were present, otherwise member counts.Authoritative not content count is the official count. This is the teller not content count when tellers are present, but member not content count when there are no tellers. |
| divisionHadTellersDivisionViewModel | boolean | Whether the division had tellers.Whether the division had tellers or not |
| tellerContentCountDivisionViewModel | integer (int32) | Content count as recorded by the tellers.Content count is count recorded by the tellers |
| tellerNotContentCountDivisionViewModel | integer (int32) | Not Content count as recorded by the tellers.Not Content count recorded by the tellers |
| memberContentCountDivisionViewModel | integer (int32) | Total tally of members who voted Content.Member content count is the total tally of all members that voted content |
| memberNotContentCountDivisionViewModel | integer (int32) | Total tally of members who voted Not Content.Member not content count is the total tally of all members that voted not content |
| sponsoringMemberIdDivisionViewModel | integer (int32) | Identifier of the member who sponsored the division.Identifier of the member who sponsored the division. |
| isHouseDivisionViewModel | boolean | Whether the division was a House division.Whether the division was a House division. |
| isInquorateDivisionViewModel | boolean | Whether the division failed to meet the required quorum.Whether the division failed to meet the required quorum. |
| amendmentMotionNotesDivisionViewModel | string | Notes relating to the amendment or motion being voted on.Notes relating to the amendment or motion being voted on. |
| isGovernmentWinDivisionViewModel | boolean | Whether the outcome favoured the government's position.Whether the outcome favoured the government's position. |
| remoteVotingStartDivisionViewModel | string (date-time) | Start time of the remote voting window.Start time of the remote voting window. |
| remoteVotingEndDivisionViewModel | string (date-time) | End time of the remote voting window.End time of the remote voting window. |
| divisionWasExclusivelyRemoteDivisionViewModel | boolean | Whether the division was conducted entirely by remote voting.Whether the division was conducted entirely by remote voting. |
| contentTellersDivisionViewModel | array<object> | List of tellers for the Content side.List of tellers for the Content side. |
| notContentTellersDivisionViewModel | array<object> | List of tellers for the Not Content side.List of tellers for the Not Content side. |
| contentsDivisionViewModel | array<object> | List of members who voted Content.List of members who voted Content. |
| notContentsDivisionViewModel | array<object> | List of members who voted Not Content.List of members who voted Not Content. |
| memberIdMemberViewModel | integer (int32) | Unique identifier of the member.Unique identifier of the member. |
| nameMemberViewModel | string | Full name of the member.Full name of the member. |
| listAsMemberViewModel | string | Name used for listing the member alphabetically.Name used for listing the member alphabetically. |
| memberFromMemberViewModel | string | Title or peerage location associated with the member.Title or peerage location associated with the member. |
| partyMemberViewModel | string | Full name of the member's political party.Full name of the member's political party. |
| partyColourMemberViewModel | string | Colour code associated with the member's party.Colour code associated with the member's party. |
| partyAbbreviationMemberViewModel | string | Abbreviated name of the member's party.Abbreviated name of the member's party. |
| partyIsMainPartyMemberViewModel | boolean | Whether the party is classed as a main party.Whether the party is classed as a main party. |
| memberWasContentMemberVotingRecordViewModel | boolean | Whether the member voted Content.Whether the member voted Content. |
| memberWasTellerMemberVotingRecordViewModel | boolean | Whether the member acted as a teller.Whether the member acted as a teller. |
| publishedDivisionMemberVotingRecordViewModel | object | Details of the division this voting record relates to.Details of the division this voting record relates to. |
| partyNamePartyVoteResultViewModel | string | Name of the party for this vote result.Name of the party for this vote result. |
| voteCountPartyVoteResultViewModel | integer (int32) | Number of votes cast by the party.Number of votes cast by the party. |
Schema captured from openapi 23 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://lordsvotes-api.parliament.uk
- Version
- v1
- Format
- openapi
- Endpoints
- 5
Try the API
/data/Divisions/{divisionId}Return a Division
/data/Divisions/searchTotalResultsReturn total results count
/data/Divisions/searchReturn a list of Divisions
/data/Divisions/membervotingReturn voting records for a Member
/data/Divisions/groupedbypartyReturn Divisions results grouped by party
Requests are proxied through our servers. Only GET endpoints are testable.
Endpoints (5)
/data5 endpoints
/data/Divisions/{divisionId}Return a Division
/data/Divisions/searchTotalResultsReturn total results count
/data/Divisions/searchReturn a list of Divisions
/data/Divisions/membervotingReturn voting records for a Member
/data/Divisions/groupedbypartyReturn Divisions results grouped by party
Query examples
curl -s 'https://lordsvotes-api.parliament.uk/swagger/v1/swagger.json' -H 'Accept: application/json'Machine-readable API description (use it to generate clients).
Machine-readable & source
Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.