Register record·API·GB·GOVERNMENTFAILING · checked 5h ago
H
House of Commons Oral and Written Questions API
This API provides access to tabled oral and written parliamentary questions, as well as motions submitted in the House of Commons. Maintained by UK Parliament, it allows users to query records of questions posed by Members of Parliament to government ministers and departments, along with associated motions. The API covers the national parliamentary scope of the United Kingdom and can be used to track legislative activity, monitor topics raised in the Commons, and research the parliamentary record without requiring authentication.An API that allows querying all tabled oral and written questions, and motions for the House of Commons.
Trust score
How is this computed?63
good
Weighted across five axes. Tap a ring for what it measures.
Data schema (111 fields)
Filterable via the API (24)
idparameters.edmIdsparameters.uINWithAmendmentSuffixparameters.searchTermparameters.currentStatusDateStartparameters.currentStatusDateEndparameters.isPrayerparameters.memberIdparameters.includeSponsoredByMemberparameters.tabledStartDateparameters.tabledEndDateparameters.statusesparameters.orderByparameters.skipparameters.takeparameters.answeringDateStartparameters.answeringDateEndparameters.questionTypeparameters.oralQuestionTimeIdparameters.askingMemberIdsparameters.uINsparameters.answeringBodyIdsparameters.deadlineDateStartparameters.deadlineDateEnd
| Field | Type | Description |
|---|---|---|
| id | integer (int32) | Unique identifier of the Early Day Motion requested.Early Day Motion with the ID specified. |
| parameters.edmIdsParameters.edm ids | array | Filter Early Day Motions by a list of IDs.Early Day Motions with an ID in the list provided. |
| parameters.uINWithAmendmentSuffixParameters.u inwith amendment suffix | string | Filter Early Day Motions by UIN combined with amendment suffix.Early Day Motions with an UINWithAmendmentSuffix provided. |
| parameters.searchTermParameters.search term | string | Filter Early Day Motions whose title contains this search term.Early Day Motions where the title includes the search term provided. |
| parameters.currentStatusDateStartParameters.current status date start | string (date-time) | Filter to motions whose current status was set on or after this date.Early Day Motions where the current status has been set on or after the date provided. Date format YYYY-MM-DD. |
| parameters.currentStatusDateEndParameters.current status date end | string (date-time) | Filter to motions whose current status was set on or before this date.Early Day Motions where the current status has been set on or before the date provided. Date format YYYY-MM-DD. |
| parameters.isPrayerParameters.is prayer | boolean | Filter to motions that are a prayer against a Negative Statutory Instrument.Early Day Motions which are a prayer against a Negative Statutory Instrument. |
| parameters.memberIdParameters.member id | integer (int32) | Filter to motions tabled by the specified Member.Return Early Day Motions tabled by Member with ID provided. |
| parameters.includeSponsoredByMemberParameters.include sponsored by member | boolean | Whether to include motions sponsored, not just tabled, by the Member.Include Early Day Motions sponsored by Member specified |
| parameters.tabledStartDateParameters.tabled start date | string (date-time) | Filter to motions tabled on or after this date.Early Day Motions where the date tabled is on or after the date provided. Date format YYYY-MM-DD. |
| parameters.tabledEndDateParameters.tabled end date | string (date-time) | Filter to motions tabled on or before this date.Early Day Motions where the date tabled is on or before the date provided. Date format YYYY-MM-DD. |
| parameters.statuses | array | Filter to motions whose current status is in this list.Early Day Motions where current status is in the selected list. |
| parameters.orderByParameters.order by | string | Field to sort results by: date tabled, title, or signature count.Order results by date tabled, title or signature count. Default is date tabled. |
| parameters.skip | integer (int32) | Number of records to skip before returning results.The number of records to skip from the first, default is 0. |
| parameters.take | integer (int32) | Maximum number of records to return.The number of records to return, default is 25, maximum is 100. |
| parameters.answeringDateStartParameters.answering date start | string (date-time) | Filter Oral Questions with an answering date on or after this date.Oral Questions where the answering date has been set on or after the date provided. Date format YYYY-MM-DD. |
| parameters.answeringDateEndParameters.answering date end | string (date-time) | Filter Oral Questions with an answering date on or before this date.Oral Questions where the answering date has been set on or before the date provided. Date format YYYY-MM-DD. |
| parameters.questionTypeParameters.question type | string | Filter Oral Questions by type: substantive or topical.Oral Questions where the question type is the selected type, substantive or topical. |
| parameters.oralQuestionTimeIdParameters.oral question time id | integer (int32) | Filter Oral Questions belonging to a specific question time.Oral Questions where the question is within the question time with the ID provided |
| parameters.askingMemberIdsParameters.asking member ids | array | Filter questions by the IDs of the asking Members.The ID of the member asking the question. Lists of member IDs for each house are available <a href="http://data.parliament.uk/membersdataplatform/services/mnis/members/query/house=Commons" target="_blank">Commons</a> and <a href="http://data.parliament.uk/membersdataplatform/services/mnis/members/qu |
| parameters.uINsParameters.u ins | array | Filter by Unique Identifying Number(s) of the question.The UIN for the question - note that UINs reset at the start of each Parliamentary session. |
| parameters.answeringBodyIdsParameters.answering body ids | array | Filter by the IDs of the government bodies expected to answer.Which answering body is to respond. A list of answering bodies can be found <a target="_blank" href="http://data.parliament.uk/membersdataplatform/services/mnis/referencedata/AnsweringBodies/">here</a>. |
| parameters.deadlineDateStartParameters.deadline date start | string (date-time) | Filter Oral Question Times with a deadline on or after this date.Oral Questions Time where the deadline date has been set on or after the date provided. Date format YYYY-MM-DD. |
| parameters.deadlineDateEndParameters.deadline date end | string (date-time) | Filter Oral Question Times with a deadline on or before this date.Oral Questions Time where the deadline date has been set on or before the date provided. Date format YYYY-MM-DD. |
| PagingInfoApiResponse[PublishedEarlyDayMotionDetails] | object | Pagination and result-count metadata for the response.Pagination and result-count metadata for the response. |
| StatusCodeApiResponse[PublishedEarlyDayMotionDetails] | string | HTTP-style status code of the API response.HTTP-style status code of the API response. |
| SuccessApiResponse[PublishedEarlyDayMotionDetails] | boolean | Indicates whether the API request succeeded.Indicates whether the API request succeeded. |
| ErrorsApiResponse[PublishedEarlyDayMotionDetails] | array<string> | List of error messages returned with the response.List of error messages returned with the response. |
| ResponseApiResponse[PublishedEarlyDayMotionDetails] | object | Main data payload returned by the API call.Main data payload returned by the API call. |
| SkipPagingInfo | integer (int32) | Number of records skipped in this page of results.Number of records skipped in this page of results. |
| TakePagingInfo | integer (int32) | Number of records requested per page.Number of records requested per page. |
| TotalPagingInfo | integer (int32) | Total number of matching records for the current filter.Total number of matching records for the current filter. |
| GlobalTotalPagingInfo | integer (int32) | Total number of records across all filters, unfiltered.Total number of records across all filters, unfiltered. |
| StatusCountsPagingInfo | array<object> | Counts of matching records grouped by status.Counts of matching records grouped by status. |
| GlobalStatusCountsPagingInfo | array<object> | Counts of all records grouped by status, ignoring filters.Counts of all records grouped by status, ignoring filters. |
| SponsorsPublishedEarlyDayMotionDetails | array<object> | List of Members sponsoring the Early Day Motion.List of Members sponsoring the Early Day Motion. |
| AmendmentsPublishedEarlyDayMotionDetails | array<object> | List of amendments tabled against the Early Day Motion.List of amendments tabled against the Early Day Motion. |
| IdPublishedEarlyDayMotionDetails | integer (int32) | Unique identifier of the Early Day Motion.Unique identifier of the Early Day Motion. |
| StatusPublishedEarlyDayMotionDetails | string | Current status of the Early Day Motion.Current status of the Early Day Motion. |
| StatusDatePublishedEarlyDayMotionDetails | string (date-time) | Date the current status was set.Date the current status was set. |
| MemberIdPublishedEarlyDayMotionDetails | integer (int32) | ID of the Member who tabled the motion.ID of the Member who tabled the motion. |
| PrimarySponsorPublishedEarlyDayMotionDetails | object | Details of the Member who is the primary sponsor.Details of the Member who is the primary sponsor. |
| TitlePublishedEarlyDayMotionDetails | string | Title of the Early Day Motion.Title of the Early Day Motion. |
| MotionTextPublishedEarlyDayMotionDetails | string | Full text of the Early Day Motion.Full text of the Early Day Motion. |
| AmendmentToMotionIdPublishedEarlyDayMotionDetails | integer (int32) | ID of the motion this amendment applies to, if any.ID of the motion this amendment applies to, if any. |
| UINPublishedEarlyDayMotionDetails | integer (int32) | Unique Identifying Number of the motion.Unique Identifying Number of the motion. |
| AmendmentSuffixPublishedEarlyDayMotionDetails | string | Suffix letter identifying an amendment to the motion.Suffix letter identifying an amendment to the motion. |
| DateTabledPublishedEarlyDayMotionDetails | string (date-time) | Date the motion was tabled.Date the motion was tabled. |
| PrayingAgainstNegativeStatutoryInstrumentIdPublishedEarlyDayMotionDetails | integer (int32) | ID of the Negative Statutory Instrument the motion prays against.ID of the Negative Statutory Instrument the motion prays against. |
| StatutoryInstrumentNumberPublishedEarlyDayMotionDetails | integer (int32) | Number of the related Statutory Instrument.Number of the related Statutory Instrument. |
| StatutoryInstrumentYearPublishedEarlyDayMotionDetails | string | Year of the related Statutory Instrument.Year of the related Statutory Instrument. |
| StatutoryInstrumentTitlePublishedEarlyDayMotionDetails | string | Title of the related Statutory Instrument.Title of the related Statutory Instrument. |
| UINWithAmendmentSuffixPublishedEarlyDayMotionDetails | string | Motion's UIN combined with its amendment suffix.Motion's UIN combined with its amendment suffix. |
| SponsorsCountPublishedEarlyDayMotionDetails | integer (int32) | Number of Members sponsoring the motion.Number of Members sponsoring the motion. |
| StatusIdStatusCount | integer (int32) | Identifier of a specific motion status.Identifier of a specific motion status. |
| CountStatusCount | integer (int32) | Number of motions with this status.Number of motions with this status. |
| MemberPublishedEarlyDayMotionSponsor | object | Details of the Member who is sponsoring the motion.Details of the Member who is sponsoring the motion. |
| SponsoringOrderPublishedEarlyDayMotionSponsor | integer (int32) | Order in which the sponsor added their name.Order in which the sponsor added their name. |
| CreatedWhenPublishedEarlyDayMotionSponsor | string (date-time) | Date and time the sponsorship record was created.Date and time the sponsorship record was created. |
| IsWithdrawnPublishedEarlyDayMotionSponsor | boolean | Whether the sponsor has withdrawn their support.Whether the sponsor has withdrawn their support. |
| WithdrawnDatePublishedEarlyDayMotionSponsor | string (date-time) | Date the sponsor withdrew their support.Date the sponsor withdrew their support. |
| MnisIdMemberForDate | integer (int32) | Member's ID in the Members Names Information Service.Member's ID in the Members Names Information Service. |
| PimsIdMemberForDate | integer (int32) | Member's ID in the Parliamentary Information Management System.Member's ID in the Parliamentary Information Management System. |
| NameMemberForDate | string | Full name of the Member.Full name of the Member. |
| ListAsMemberForDate | string | Name used to list the Member alphabetically.Name used to list the Member alphabetically. |
| ConstituencyMemberForDate | string | Constituency represented by the Member.Constituency represented by the Member. |
| PartyMemberForDate | string | Political party of the Member.Political party of the Member. |
| PartyIdMemberForDate | integer (int32) | Identifier of the Member's political party.Identifier of the Member's political party. |
| PartyColourMemberForDate | string | Colour associated with the Member's party.Colour associated with the Member's party. |
| PhotoUrlMemberForDate | string | URL of the Member's photograph.URL of the Member's photograph. |
| QuestionTypePublishedWrittenQuestion | string | Type of the written question, e.g. named day or ordinary.Type of the written question, e.g. named day or ordinary. |
| QuestionTextPublishedWrittenQuestion | string | Full text of the written question.Full text of the written question. |
| AnsweringBodyIdPublishedWrittenQuestion | integer (int32) | ID of the government body expected to answer.ID of the government body expected to answer. |
| AnsweringBodyPublishedWrittenQuestion | string | Name of the government body expected to answer.Name of the government body expected to answer. |
| DueForAnswerPublishedWrittenQuestion | string (date-time) | Date by which the question is due to be answered.Date by which the question is due to be answered. |
| AnsweredWhenPublishedWrittenQuestion | string (date-time) | Date the question was answered.Date the question was answered. |
| TabledWhenPublishedWrittenQuestion | string (date-time) | Date the question was tabled.Date the question was tabled. |
| AskingMemberPublishedWrittenQuestion | object | Details of the Member who asked the question.Details of the Member who asked the question. |
| AnsweringMinisterPublishedWrittenQuestion | object | Details of the minister who answered the question.Details of the minister who answered the question. |
| AnswerPublishedWrittenQuestion | string | Full text of the answer given.Full text of the answer given. |
| AnsweringMinisterTitlePublishedWrittenQuestion | string | Title of the minister who gave the answer.Title of the minister who gave the answer. |
| AskingMemberIdPublishedWrittenQuestion | integer (int32) | ID of the Member who asked the question.ID of the Member who asked the question. |
| AnsweringMinisterIdPublishedWrittenQuestion | integer (int32) | ID of the minister who answered the question.ID of the minister who answered the question. |
| EdmIdsPublishedEarlyDayMotionQueryParameters | array<integer (int32)> | List of Early Day Motion IDs to filter by.Early Day Motions with an ID in the list provided. |
| SearchTermPublishedEarlyDayMotionQueryParameters | string | Search term to match within motion titles.Early Day Motions where the title includes the search term provided. |
| CurrentStatusDateStartPublishedEarlyDayMotionQueryParameters | string (date-time) | Start date for filtering by current status date.Early Day Motions where the current status has been set on or after the date provided. Date format YYYY-MM-DD. |
| CurrentStatusDateEndPublishedEarlyDayMotionQueryParameters | string (date-time) | End date for filtering by current status date.Early Day Motions where the current status has been set on or before the date provided. Date format YYYY-MM-DD. |
| IsPrayerPublishedEarlyDayMotionQueryParameters | boolean | Whether to filter for motions praying against a Negative Statutory Instrument.Early Day Motions which are a prayer against a Negative Statutory Instrument. |
| IncludeSponsoredByMemberPublishedEarlyDayMotionQueryParameters | boolean | Whether to include motions sponsored by the given Member.Include Early Day Motions sponsored by Member specified |
| TabledStartDatePublishedEarlyDayMotionQueryParameters | string (date-time) | Start date for filtering by date tabled.Early Day Motions where the date tabled is on or after the date provided. Date format YYYY-MM-DD. |
| TabledEndDatePublishedEarlyDayMotionQueryParameters | string (date-time) | End date for filtering by date tabled.Early Day Motions where the date tabled is on or before the date provided. Date format YYYY-MM-DD. |
| StatusesPublishedEarlyDayMotionQueryParameters | array<string> | List of statuses to filter motions by.Early Day Motions where current status is in the selected list. |
| OrderByPublishedEarlyDayMotionQueryParameters | string | Field used to sort the returned motions.Order results by date tabled, title or signature count. Default is date tabled. |
| AnsweringDateStartPublishedOralQuestionQueryParameters | string (date-time) | Start date for filtering Oral Questions by answering date.Oral Questions where the answering date has been set on or after the date provided. Date format YYYY-MM-DD. |
| AnsweringDateEndPublishedOralQuestionQueryParameters | string (date-time) | End date for filtering Oral Questions by answering date.Oral Questions where the answering date has been set on or before the date provided. Date format YYYY-MM-DD. |
| OralQuestionTimeIdPublishedOralQuestionQueryParameters | integer (int32) | ID of the question time to filter Oral Questions by.Oral Questions where the question is within the question time with the ID provided |
| AskingMemberIdsPublishedOralQuestionQueryParameters | array<integer (int32)> | List of Member IDs to filter questions by asker.The ID of the member asking the question. Lists of member IDs for each house are available <a href="http://data.parliament.uk/membersdataplatform/services/mnis/members/query/house=Commons" target="_blank">Commons</a> and <a href="http://data.parliament.uk/membersdataplatform/services/mnis/members/qu |
| UINsPublishedOralQuestionQueryParameters | array<integer (int32)> | List of Unique Identifying Numbers to filter questions by.The UIN for the question - note that UINs reset at the start of each Parliamentary session. |
| AnsweringBodyIdsPublishedOralQuestionQueryParameters | array<integer (int32)> | List of answering body IDs to filter questions by.Which answering body is to respond. A list of answering bodies can be found <a target="_blank" href="http://data.parliament.uk/membersdataplatform/services/mnis/referencedata/AnsweringBodies/">here</a>. |
| NumberPublishedOralQuestion | integer (int32) | Order number of the oral question in its session.Order number of the oral question in its session. |
| RemovedFromToBeAskedWhenPublishedOralQuestion | string (date-time) | Date the question was removed from the list to be asked.Date the question was removed from the list to be asked. |
| DeclarableInterestDetailPublishedOralQuestion | string | Details of a declarable interest relevant to the question.Details of a declarable interest relevant to the question. |
| HansardLinkPublishedOralQuestion | string | Link to the Hansard record of the question.Link to the Hansard record of the question. |
| AnsweringWhenPublishedOralQuestion | string (date-time) | Date and time the question was or will be answered.Date and time the question was or will be answered. |
| DeadlineDateStartPublishedOralQuestionTimeQueryParameters | string (date-time) | Start date for filtering Oral Question Times by deadline.Oral Questions Time where the deadline date has been set on or after the date provided. Date format YYYY-MM-DD. |
| DeadlineDateEndPublishedOralQuestionTimeQueryParameters | string (date-time) | End date for filtering Oral Question Times by deadline.Oral Questions Time where the deadline date has been set on or before the date provided. Date format YYYY-MM-DD. |
| DeadlineWhenPublishedOralQuestionTime | string (date-time) | Deadline date and time for tabling questions for this slot.Deadline date and time for tabling questions for this slot. |
| SubstantiveTimePublishedOralQuestionTime | string | Scheduled time for substantive oral questions.Scheduled time for substantive oral questions. |
| TopicalTimePublishedOralQuestionTime | string | Scheduled time for topical oral questions.Scheduled time for topical oral questions. |
| AnsweringBodyNamesPublishedOralQuestionTime | string | Names of the government bodies answering in this question time.Names of the government bodies answering in this question time. |
| AnsweringMinisterTitlesPublishedOralQuestionTime | string | Titles of the ministers answering in this question time.Titles of the ministers answering in this question time. |
Schema captured from openapi 20 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://oralquestionsandmotions-api.parliament.uk
- Version
- v1
- Format
- openapi
- Endpoints
- 4
Try the API
GET
/EarlyDayMotion/{id}Returns a single Early Day Motion by ID
GET
/EarlyDayMotions/listReturns a list of Early Day Motions
GET
/oralquestions/listReturns a list of oral questions
GET
/oralquestiontimes/listReturns a list of oral question times
Requests are proxied through our servers. Only GET endpoints are testable.
Endpoints (4)
/EarlyDayMotion1 endpoint
GET
/EarlyDayMotion/{id}Returns a single Early Day Motion by ID
/EarlyDayMotions1 endpoint
GET
/EarlyDayMotions/listReturns a list of Early Day Motions
/oralquestions1 endpoint
GET
/oralquestions/listReturns a list of oral questions
/oralquestiontimes1 endpoint
GET
/oralquestiontimes/listReturns a list of oral question times
Query examples
curl -s 'https://oralquestionsandmotions-api.parliament.uk/swagger/docs/v1' -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.