Register record·API·GB·GOVERNMENTVERIFIED · checked 32m ago
M
Members API
An API provided by the UK Parliament that retrieves data on Members, including Members of the House of Commons and House of Lords. It offers structured access to information such as membership details, biographical data, and related parliamentary records. The API is freely accessible without authentication and is aimed at supporting applications and services that need up-to-date data on current and former Members of Parliament, covering national-level parliamentary information for the United Kingdom.An API which retrieves Members data.
Trust score
How is this computed?74
good
Weighted across five axes. Tap a ring for what it measures.
Data schema (123 fields)
Filterable via the API (40)
locationTypelocationNamesearchTextskiptakeidelectionIdsearchTermpageincludeDeletedNameLocationPostTitlePartyIdHouseConstituencyIdNameStartsWithGenderMembershipStartedSinceMembershipEnded.MembershipEndedSinceMembershipEnded.MembershipEndReasonIdsMembershipInDateRange.WasMemberOnOrAfterMembershipInDateRange.WasMemberOnOrBeforeMembershipInDateRange.WasMemberOfHouseIsEligibleIsCurrentMemberPolicyInterestIdExperiencenamedateToSearchFordetailsForDateidscropTypewebVersionhouseforDatedepartmentIdpartyIdtypenameContains
| Field | Type | Description |
|---|---|---|
| locationTypeLocation type | string | Type of location used to filter results.Location by type of location |
| locationNameLocation name | string | Name of the location to filter results by.Location by name specified |
| searchTextSearch text | string | Search term to match against constituency names.Constituencies containing serach term in their name |
| skip | integer (int32) | Number of records to skip before returning results, default 0.The number of records to skip from the first, default is 0 |
| take | integer (int32) | Number of records to return, default and maximum 20.The number of records to return, default is 20. Maximum is 20 |
| id | integer (int32) | Filters results by constituency ID.Constituency by ID |
| electionIdElection id | integer (int32) | Filters election results by election ID.Election result by election id |
| searchTermSearch term | string | Search term to match against registered interests.Registered interests containing search term |
| page | integer (int32) | Page number of results to return, 20 results per page.Page of results to return, default 0. Results per page 20. |
| includeDeletedInclude deleted | boolean | Whether to include registered interests that have been deleted.Registered interests that have been deleted |
| Name | string | Filters members whose name contains the given term.Members where name contains term specified |
| Location | string | Filters members by postcode or geographical location match.Members where postcode or geographical location matches the term specified Searches for current constituencies with full postcode, or outward code; and name of constituency If there are no results based on above, searches for all current and past constituencies in specified area of UK. |
| PostTitlePost title | string | Filters members who have held the specified post.Members which have held the post specified |
| PartyIdParty id | integer (int32) | Filters members currently affiliated with the given party ID.Members which are currently affiliated with party with party ID |
| House | string | Filters members by their most recent House.Members where their most recent house is the house specified |
| ConstituencyIdConstituency id | integer (int32) | Filters members who currently hold the given constituency.Members which currently hold the constituency with constituency id |
| NameStartsWithName starts with | string | Filters members whose surname starts with the given letters.Members with surname begining with letter(s) specified |
| Gender | string | Filters members by gender.Members with the gender specified |
| MembershipStartedSinceMembership started since | string (date-time) | Filters members who started membership on or after this date.Members who started on or after the date given |
| MembershipEnded.MembershipEndedSinceMembership ended.membership ended since | string (date-time) | Filters members who left the House on or after this date.Members who left the House on or after the date given |
| MembershipEnded.MembershipEndReasonIdsMembership ended.membership end reason ids | array | List of reason IDs for a member's membership ending.List of reason IDs for a member's membership ending. |
| MembershipInDateRange.WasMemberOnOrAfterMembership in date range.was member on or after | string (date-time) | Filters members who were active on or after this date.Members who were active on or after the date specified |
| MembershipInDateRange.WasMemberOnOrBeforeMembership in date range.was member on or before | string (date-time) | Filters members who were active on or before this date.Members who were active on or before the date specified |
| MembershipInDateRange.WasMemberOfHouseMembership in date range.was member of house | string | Filters members who were active in the specified House.Members who were active in the house specifid |
| IsEligibleIs eligible | boolean | Whether the member is currently eligible to sit in their House.Members currently Eligible to sit in their House |
| IsCurrentMemberIs current member | boolean | Whether to filter for current or former members.Members who are current or former members |
| PolicyInterestIdPolicy interest id | integer (int32) | Filters members by a specified policy interest ID.Members with specified policy interest |
| Experience | string | Filters members by a specified experience.Members with specified experience |
| name | string | Filters members whose name contains the given term.Members with names containing the term specified |
| dateToSearchForDate to search for | string (date-time) | Filters members who were active in the Commons or Lords on this date.Members that were an active member of the Commons or Lords on the date specified |
| detailsForDateDetails for date | string (date-time) | Date for which member details should be populated.Member object will be populated with details from the date specified |
| ids | array | List of member IDs to retrieve.List of MemberIds to find |
| cropTypeCrop type | string | Type of image crop to apply to the member's photo.Type of image crop to apply to the member's photo. |
| webVersionWeb version | boolean | Whether to return the web-optimised version of the image.Whether to return the web-optimised version of the image. |
| house | string | Filters registered interests of a member by House.Registered interests of Member by House specified |
| forDateFor date | string (date-time) | Date for which the state of parties is requested.State of parties for the date specified |
| departmentIdDepartment id | integer (int32) | Filters government posts by department ID.Government posts by department ID |
| partyIdParty id | integer (int32) | Filters spokespersons by party ID.Spokespersons by party ID |
| type | string | Filters departments by type.Departments by type |
| nameContainsName contains | string | Filters results whose name contains the given term.Filters results whose name contains the given term. |
| shortNameAnsweringBody | string | Short name of the answering government body.Short name of the answering government body. |
| targetAnsweringBody | string | Target reference for the answering body.Target reference for the answering body. |
| departmentAnsweringBody | unknown | Department associated with the answering body.Department associated with the answering body. |
| typeIdBiographyExperience | integer (int32) | Identifier for the type of biography experience entry.Identifier for the type of biography experience entry. |
| titleBiographyExperience | string | Job title held in this biography experience entry.Job title held in this biography experience entry. |
| organisationBiographyExperience | string | Organisation associated with this biography experience entry.Organisation associated with this biography experience entry. |
| startMonthBiographyExperience | integer (int32) | Month the experience entry started.Month the experience entry started. |
| startYearBiographyExperience | integer (int32) | Year the experience entry started.Year the experience entry started. |
| endMonthBiographyExperience | integer (int32) | Month the experience entry ended.Month the experience entry ended. |
| endYearBiographyExperience | integer (int32) | Year the experience entry ended.Year the experience entry ended. |
| valueBiographyExperienceListItem | array<object> | List of biography experience entries.List of biography experience entries. |
| linksBiographyExperienceListItem | array<object> | Related links for the biography experience list.Related links for the biography experience list. |
| startDateBiographyItem | string (date-time) | Date the biography item started.Date the biography item started. |
| endDateBiographyItem | string (date-time) | Date the biography item ended.Date the biography item ended. |
| additionalInfoBiographyItem | string | Additional text information about the biography item.Additional text information about the biography item. |
| additionalInfoLinkBiographyItem | string | Link to further information about the biography item.Link to further information about the biography item. |
| currentRepresentationConstituency | unknown | Current member representing this constituency.Current member representing this constituency. |
| itemsConstituencyMembersServiceSearchResult | array<object> | List of constituency members search result items.List of constituency members search result items. |
| totalResultsConstituencyMembersServiceSearchResult | integer (int32) | Total number of results found for the search.Total number of results found for the search. |
| resultContextConstituencyMembersServiceSearchResult | string | Contextual information about the search result.Contextual information about the search result. |
| resultTypeConstituencyMembersServiceSearchResult | unknown | Type classification of the search result.Type classification of the search result. |
| memberConstituencyRepresentation | unknown | Member details for this constituency representation.Member details for this constituency representation. |
| representationConstituencyRepresentation | unknown | Representation details for the constituency member.Representation details for the constituency member. |
| typeDescriptionContactInformation | string | Description of the contact information type.Description of the contact information type. |
| isPreferredContactInformation | boolean | Whether this is the preferred contact method.Whether this is the preferred contact method. |
| isWebAddressContactInformation | boolean | Whether the contact entry is a web address.Whether the contact entry is a web address. |
| notesContactInformation | string | Additional notes about the contact information.Additional notes about the contact information. |
| line1ContactInformation | string | First line of the contact address.First line of the contact address. |
| line2ContactInformation | string | Second line of the contact address.Second line of the contact address. |
| line3ContactInformation | string | Third line of the contact address.Third line of the contact address. |
| line4ContactInformation | string | Fourth line of the contact address.Fourth line of the contact address. |
| line5ContactInformation | string | Fifth line of the contact address.Fifth line of the contact address. |
| postcodeContactInformation | string | Postcode of the contact address.Postcode of the contact address. |
| phoneContactInformation | string | Telephone number for the contact.Telephone number for the contact. |
| faxContactInformation | string | Fax number for the contact.Fax number for the contact. |
| emailContactInformation | string | Email address for the contact.Email address for the contact. |
| websiteContactInformation | string | Website address for the contact.Website address for the contact. |
| totalContributionsDebateContribution | integer (int32) | Total number of contributions in the debate.Total number of contributions in the debate. |
| debateTitleDebateContribution | string | Title of the debate.Title of the debate. |
| debateIdDebateContribution | integer (int32) | Identifier for the debate.Identifier for the debate. |
| debateWebsiteIdDebateContribution | string | Website identifier for the debate.Website identifier for the debate. |
| sittingDateDebateContribution | string (date-time) | Date the debate sitting took place.Date the debate sitting took place. |
| sectionDebateContribution | string | Section of parliamentary business the debate falls under.Section of parliamentary business the debate falls under. |
| firstTimecodeDebateContribution | string (date-time) | Timestamp of the first contribution in the debate.Timestamp of the first contribution in the debate. |
| speechCountDebateContribution | integer (int32) | Number of speeches made in the debate.Number of speeches made in the debate. |
| questionCountDebateContribution | integer (int32) | Number of questions asked in the debate.Number of questions asked in the debate. |
| supplementaryQuestionCountDebateContribution | integer (int32) | Number of supplementary questions asked in the debate.Number of supplementary questions asked in the debate. |
| interventionCountDebateContribution | integer (int32) | Number of interventions made in the debate.Number of interventions made in the debate. |
| answerCountDebateContribution | integer (int32) | Number of answers given in the debate.Number of answers given in the debate. |
| pointsOfOrderCountDebateContribution | integer (int32) | Number of points of order raised in the debate.Number of points of order raised in the debate. |
| statementsCountDebateContribution | integer (int32) | Number of statements made in the debate.Number of statements made in the debate. |
| numberEarlyDayMotion | string | Reference number of the early day motion.Reference number of the early day motion. |
| isPrayerEarlyDayMotion | boolean | Whether the early day motion is a prayer motion.Whether the early day motion is a prayer motion. |
| isAmendmentEarlyDayMotion | boolean | Whether the early day motion is an amendment.Whether the early day motion is an amendment. |
| dateTabledEarlyDayMotion | string (date-time) | Date the early day motion was tabled.Date the early day motion was tabled. |
| sponsorsCountEarlyDayMotion | integer (int32) | Number of sponsors supporting the early day motion.Number of sponsors supporting the early day motion. |
| memberIdElectionCandidate | integer (int32) | Identifier of the member standing as a candidate.Identifier of the member standing as a candidate. |
| partyElectionCandidate | unknown | Political party of the election candidate.Political party of the election candidate. |
| resultChangeElectionCandidate | string | Change in result compared to a previous election.Change in result compared to a previous election. |
| rankOrderElectionCandidate | integer (int32) | Rank order of the candidate by votes received.Rank order of the candidate by votes received. |
| votesElectionCandidate | integer (int32) | Number of votes received by the candidate.Number of votes received by the candidate. |
| voteShareElectionCandidate | number (double) | Percentage share of the vote received by the candidate.Percentage share of the vote received by the candidate. |
| resultElectionResult | string | Outcome of the election result.Outcome of the election result. |
| isNotionalElectionResult | boolean | Whether the election result is a notional calculation.Whether the election result is a notional calculation. |
| electorateElectionResult | integer (int32) | Total number of registered electors in the constituency.Total number of registered electors in the constituency. |
| turnoutElectionResult | integer (int32) | Number of votes cast in the election.Number of votes cast in the election. |
| majorityElectionResult | integer (int32) | Vote margin between the winning and second-placed candidate.Vote margin between the winning and second-placed candidate. |
| winningPartyElectionResult | unknown | Political party that won the election.Political party that won the election. |
| electionTitleElectionResult | string | Title of the election.Title of the election. |
| electionDateElectionResult | string (date-time) | Date the election was held.Date the election was held. |
| isGeneralElectionElectionResult | boolean | Whether the election was a general election.Whether the election was a general election. |
| constituencyNameElectionResult | string | Name of the constituency for this election result.Name of the constituency for this election result. |
| candidatesElectionResult | array<object> | List of candidates who stood in the election.List of candidates who stood in the election. |
| descriptionGenericReferenceData | string | Descriptive text for this reference data item.Descriptive text for this reference data item. |
| urlGovernmentDepartment | string | Web address for the government department.Web address for the government department. |
| imageUrlGovernmentDepartment | string | URL of the image representing the government department.URL of the image representing the government department. |
| hansardNameGovernmentOppositionPost | string | Hansard name for the government or opposition post.Hansard name for the government or opposition post. |
| postHoldersGovernmentOppositionPost | array<object> | List of people who have held this post.List of people who have held this post. |
| governmentDepartmentsGovernmentOppositionPost | array<object> | List of government departments associated with this post.List of government departments associated with this post. |
| createdWhenGovernmentOppositionPost | string (date-time) | Date the post record was created.Date the post record was created. |
| orderGovernmentOppositionPost | integer (int32) | Display order of the post relative to others.Display order of the post relative to others. |
| layingMinisterNameGovernmentOppositionPostHolder | string | Name of the laying minister for this post.Name of the laying minister for this post. |
| isPaidGovernmentOppositionPostHolder | boolean | Whether the post holder receives a salary for the role.Whether the post holder receives a salary for the role. |
Schema captured from openapi 22 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://members-api.parliament.uk
- Version
- v1
- Format
- openapi
- Endpoints
- 43
Try the API
GET
/api/Location/Browse/{locationType}/{locationName}Returns a list of locations, both parent and child
GET
/api/Location/Constituency/SearchReturns a list of constituencies
GET
/api/Location/Constituency/{id}Returns a constituency by ID
GET
/api/Location/Constituency/{id}/SynopsisReturns a synopsis by constituency ID
GET
/api/Location/Constituency/{id}/RepresentationsReturns a list of representations by constituency ID
Requests are proxied through our servers. Only GET endpoints are testable.
Endpoints (43)
/api43 endpoints
GET
/api/Location/Browse/{locationType}/{locationName}Returns a list of locations, both parent and child
GET
/api/Location/Constituency/SearchReturns a list of constituencies
GET
/api/Location/Constituency/{id}Returns a constituency by ID
GET
/api/Location/Constituency/{id}/SynopsisReturns a synopsis by constituency ID
GET
/api/Location/Constituency/{id}/RepresentationsReturns a list of representations by constituency ID
GET
/api/Location/Constituency/{id}/GeometryReturns geometry by constituency ID
GET
/api/Location/Constituency/{id}/ElectionResultsReturns a list of election results by constituency ID
GET
/api/Location/Constituency/{id}/ElectionResult/{electionId}Returns an election result by constituency and election id
GET
/api/Location/Constituency/{id}/ElectionResult/LatestReturns latest election result by constituency id
GET
/api/LordsInterests/RegisterReturns a list of registered interests
GET
/api/LordsInterests/StaffReturns a list of staff
GET
/api/Members/SearchReturns a list of current members of the Commons or Lords
GET
/api/Members/SearchHistoricalReturns a list of members of the Commons or Lords
GET
/api/Members/{id}Return member by ID
GET
/api/Members/{id}/BiographyReturn biography of member by ID
GET
/api/Members/{id}/ContactReturn list of contact details of member by ID
GET
/api/Members/{id}/ContributionSummaryReturn contribution summary of member by ID
GET
/api/Members/{id}/EdmsReturn list of early day motions of member by ID
GET
/api/Members/{id}/ExperienceReturn experience of member by ID
GET
/api/Members/{id}/FocusReturn list of areas of focus of member by ID
GET
/api/Members/HistoryReturn members by ID with list of their historical names, parties and memberships
GET
/api/Members/{id}/LatestElectionResultReturn latest election result of member by ID
GET
/api/Members/{id}/PortraitReturn portrait of member by ID
GET
/api/Members/{id}/PortraitUrlReturn portrait url of member by ID
GET
/api/Members/{id}/RegisteredInterestsReturn list of registered interests of member by ID
GET
/api/Members/{id}/StaffReturn list of staff of member by ID
GET
/api/Members/{id}/SynopsisReturn synopsis of member by ID
GET
/api/Members/{id}/ThumbnailReturn thumbnail of member by ID
GET
/api/Members/{id}/ThumbnailUrlReturn thumbnail url of member by ID
GET
/api/Members/{id}/VotingReturn list of votes by member by ID
GET
/api/Members/{id}/WrittenQuestionsReturn list of written questions by member by ID
GET
/api/Parties/StateOfTheParties/{house}/{forDate}Returns current state of parties
GET
/api/Parties/LordsByType/{forDate}Returns the composition of the House of Lords by peerage type.
GET
/api/Parties/GetActive/{house}Returns a list of current parties with at least one active member.
GET
/api/Posts/GovernmentPostsReturns a list of government posts.
GET
/api/Posts/OppositionPostsReturns a list of opposition posts.
GET
/api/Posts/SpokespersonsReturns a list of spokespersons.
GET
/api/Posts/Departments/{type}Returns a list of departments.
GET
/api/Posts/SpeakerAndDeputies/{forDate}Returns a list containing the speaker and deputy speakers.
GET
/api/Reference/PolicyInterestsReturns a list of policy interest.
GET
/api/Reference/DepartmentsReturns a list of departments.
GET
/api/Reference/AnsweringBodiesReturns a list of answering bodies.
GET
/api/Reference/Departments/{id}/LogoReturns department logo.
Query examples
curl -s 'https://members-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.