Register record·API·GB·GOVERNMENTVERIFIED · checked 6h ago
B
Bills API
This API, maintained by UK Parliament, provides access to information about Bills progressing through the UK legislative process. It allows users to search for and retrieve data on individual Bills, including their current and past stages, associated amendments, and related publications. The service covers national legislation and is intended for accessing structured, up-to-date parliamentary data on the status and history of Bills under consideration by Parliament, without requiring authentication for access.”}, free of charge and open to the public.”}API to get and search for information regarding Bills, their stages, associated amendments and publications.
legislation
Trust score
How is this computed?74
good
Weighted across five axes. Tap a ring for what it measures.
Data schema (111 fields)
Filterable via the API (31)
billIdbillStageIdSearchTermAmendmentNumberDecisionMemberIdSkipTakeamendmentIdCategorySessionCurrentHouseOriginatingHouseDepartmentIdBillStageBillStagesExcludedIsDefeatedIsWithdrawnBillTypeSortOrderBillIdsIsInAmendableStagepublicationIddocumentIdpingPongItemIddatestageIdidHouseDateFromDateTo
| Field | Type | Description |
|---|---|---|
| billIdBill id | integer (int32) | Identifier of the Bill to filter amendments by.Amendments relating to a Bill with Bill ID specified |
| billStageIdBill stage id | integer (int32) | Identifier of the Bill stage to filter amendments by.Amendments relating to a Bill stage with Bill stage ID specified |
| SearchTermSearch term | string | Text used to search within the results.Text used to search within the results. |
| AmendmentNumberAmendment number | string | Amendment number used to filter results.Amendment number used to filter results. |
| Decision | string | Decision outcome used to filter amendments.Decision outcome used to filter amendments. |
| MemberIdMember id | integer (int32) | Identifier of a member used to filter results.Identifier of a member used to filter results. |
| Skip | integer (int32) | Number of records to skip for pagination.Number of records to skip for pagination. |
| Take | integer (int32) | Maximum number of records to return.Maximum number of records to return. |
| amendmentIdAmendment id | integer (int32) | Identifier of a specific amendment.Amendment with amendment ID specified |
| Category | string | Category used to filter results.Category used to filter results. |
| Session | integer (int32) | Parliamentary session identifier used to filter results.Parliamentary session identifier used to filter results. |
| CurrentHouseCurrent house | string | House the Bill currently resides in.House the Bill currently resides in. |
| OriginatingHouseOriginating house | string | House in which the Bill originated.House in which the Bill originated. |
| DepartmentIdDepartment id | integer (int32) | Identifier of the government department associated with the Bill.Identifier of the government department associated with the Bill. |
| BillStageBill stage | array | List of Bill stages used to filter results.List of Bill stages used to filter results. |
| BillStagesExcludedBill stages excluded | array | List of Bill stages to exclude from results.List of Bill stages to exclude from results. |
| IsDefeatedIs defeated | boolean | Whether the Bill was defeated.Whether the Bill was defeated. |
| IsWithdrawnIs withdrawn | boolean | Whether the Bill was withdrawn.Whether the Bill was withdrawn. |
| BillTypeBill type | array | List of Bill types used to filter results.List of Bill types used to filter results. |
| SortOrderSort order | string | Order in which results should be sorted.Order in which results should be sorted. |
| BillIdsBill ids | array | List of Bill identifiers used to filter results.List of Bill identifiers used to filter results. |
| IsInAmendableStageIs in amendable stage | boolean | Whether the Bill is currently in an amendable stage.Whether the Bill is currently in an amendable stage. |
| publicationIdPublication id | integer (int32) | Identifier of a specific publication document.Document with publication Id specified |
| documentIdDocument id | integer (int32) | Identifier of a specific document.Document with Id specified |
| pingPongItemIdPing pong item id | integer (int32) | Identifier of a specific ping pong motion or amendment item.Motions or amendments with ping pong item ID specified |
| date | string (date-time) | Date used to filter publications by their display date.Publications with a display date matching this date. |
| stageIdStage id | integer (int32) | Identifier of a specific Bill stage.Identifier of a specific Bill stage. |
| id | integer (int32) | Unique identifier of the Bill.Id of Bill |
| House | string | House associated with the Bill or stage.House associated with the Bill or stage. |
| DateFromDate from | string (date-time) | Start date used to filter results.Start date used to filter results. |
| DateToDate to | string (date-time) | End date used to filter results.End date used to filter results. |
| statusIndicatorAmendmentDetail | string | Status indicator of the amendment.Status indicator of the amendment. |
| decisionAmendmentDetail | object | Decision made on the amendment.Decision made on the amendment. |
| decisionExplanationAmendmentDetail | string | Explanation of the decision made on the amendment.Explanation of the decision made on the amendment. |
| sponsorsAmendmentDetail | array<object> | List of members sponsoring the amendment.List of members sponsoring the amendment. |
| amendmentTypeAmendmentDetail | object | Type classification of the amendment.Type classification of the amendment. |
| clauseAmendmentDetail | integer (int32) | Clause number the amendment relates to.Clause number the amendment relates to. |
| scheduleAmendmentDetail | integer (int32) | Schedule number the amendment relates to.Schedule number the amendment relates to. |
| pageNumberAmendmentDetail | integer (int32) | Page number the amendment appears on.Page number the amendment appears on. |
| lineNumberAmendmentDetail | integer (int32) | Line number the amendment appears on.Line number the amendment appears on. |
| amendmentPositionAmendmentDetail | string | Position of the amendment within the Bill text.Position of the amendment within the Bill text. |
| marshalledListTextAmendmentDetail | string | Text of the amendment as it appears in the marshalled list.Text of the amendment as it appears in the marshalled list. |
| dNumAmendmentDetail | string | Amendment reference number, sometimes prefixed with D.Amendment reference number, sometimes prefixed with D. |
| amendmentLinesAmendmentDetail | array<object> | Lines of text making up the amendment.Lines of text making up the amendment. |
| explanatoryTextPrefixAmendmentDetail | string | Prefix text preceding the amendment's explanatory text.Prefix text preceding the amendment's explanatory text. |
| explanatoryTextAmendmentDetail | string | Explanatory text describing the purpose of the amendment.Explanatory text describing the purpose of the amendment. |
| amendmentNoteAmendmentDetail | string | Additional note attached to the amendment.Additional note attached to the amendment. |
| amendmentLocationAmendmentDetail | string | Location within the Bill where the amendment applies.Location within the Bill where the amendment applies. |
| mainHeaderAmendmentDetail | string | Main header text associated with the amendment.Main header text associated with the amendment. |
| typeAmendmentDetailMotionDetailPingPongItem | object | Type of the ping pong item, such as amendment or motion.Type of the ping pong item, such as amendment or motion. |
| amendmentAmendmentDetailMotionDetailPingPongItem | object | Amendment details associated with the ping pong item.Amendment details associated with the ping pong item. |
| motionAmendmentDetailMotionDetailPingPongItem | object | Motion details associated with the ping pong item.Motion details associated with the ping pong item. |
| textAmendmentGroup | array<object> | Text content of the amendment group.Text content of the amendment group. |
| amendmentsAmendmentGroup | array<object> | List of amendments belonging to the group.List of amendments belonging to the group. |
| sortOrderAmendmentGroup | integer (int32) | Order in which the amendment group is displayed.Order in which the amendment group is displayed. |
| indentationAmendmentLine | integer (int32) | Level of text indentation for the amendment line.Level of text indentation for the amendment line. |
| hangingIndentationAmendmentLine | string | Hanging indentation formatting for the amendment line.Hanging indentation formatting for the amendment line. |
| isImageAmendmentLine | boolean | Whether the amendment line content is an image.Whether the amendment line content is an image. |
| imageTypeAmendmentLine | string | Type of image used in the amendment line.Type of image used in the amendment line. |
| memberIdAmendmentMember | integer (int32) | Identifier of the member associated with the amendment.Identifier of the member associated with the amendment. |
| nameAmendmentMember | string | Name of the member.Name of the member. |
| partyAmendmentMember | string | Political party of the member.Political party of the member. |
| partyColourAmendmentMember | string | Colour code associated with the member's party.Colour code associated with the member's party. |
| houseAmendmentMember | object | House the member belongs to.House the member belongs to. |
| memberPhotoAmendmentMember | string | URL of the member's photo.URL of the member's photo. |
| memberPageAmendmentMember | string | URL of the member's profile page.URL of the member's profile page. |
| memberFromAmendmentMember | string | Constituency or region the member represents.Constituency or region the member represents. |
| isLeadAmendmentMember | boolean | Whether the member is the lead sponsor of the amendment.Whether the member is the lead sponsor of the amendment. |
| summaryTextAmendmentSearchItem | array<string> | Summary text describing the amendment search result.Summary text describing the amendment search result. |
| itemsAmendmentSearchItemSearchResult | array<object> | List of amendment search result items.List of amendment search result items. |
| totalResultsAmendmentSearchItemSearchResult | integer (int32) | Total number of results matching the search.Total number of results matching the search. |
| itemsPerPageAmendmentSearchItemSearchResult | integer (int32) | Number of results returned per page.Number of results returned per page. |
| shortTitleBill | string | Short title of the Bill.Short title of the Bill. |
| formerShortTitleBill | string | Previous short title used for the Bill.Previous short title used for the Bill. |
| currentHouseBill | object | House the Bill is currently in.House the Bill is currently in. |
| originatingHouseBill | object | House in which the Bill originated.House in which the Bill originated. |
| lastUpdateBill | string (date-time) | Date the Bill's record was last updated.Date the Bill's record was last updated. |
| billWithdrawnBill | string (date-time) | Date the Bill was withdrawn, if applicable.Date the Bill was withdrawn, if applicable. |
| isDefeatedBill | boolean | Whether the Bill was defeated.Whether the Bill was defeated. |
| billTypeIdBill | integer (int32) | Identifier of the Bill's type.Identifier of the Bill's type. |
| introducedSessionIdBill | integer (int32) | Identifier of the session in which the Bill was introduced.Identifier of the session in which the Bill was introduced. |
| includedSessionIdsBill | array<integer (int32)> | List of session identifiers the Bill has been part of.List of session identifiers the Bill has been part of. |
| isActBill | boolean | Whether the Bill has become an Act.Whether the Bill has become an Act. |
| currentStageBill | object | Current stage the Bill is at.Current stage the Bill is at. |
| longTitleBill | string | Full legal title of the Bill.Full legal title of the Bill. |
| summaryBill | string | Summary description of the Bill's purpose.Summary description of the Bill's purpose. |
| promotersBill | array<object> | List of organisations or people promoting the Bill.List of organisations or people promoting the Bill. |
| petitioningPeriodBill | string | Period during which petitions against the Bill can be lodged.Period during which petitions against the Bill can be lodged. |
| petitionInformationBill | string | Information about petitioning arrangements for the Bill.Information about petitioning arrangements for the Bill. |
| agentBill | object | Agent responsible for handling the Bill's petitions.Agent responsible for handling the Bill's petitions. |
| addressBillAgent | string | Postal address of the Bill agent.Postal address of the Bill agent. |
| phoneNoBillAgent | string | Phone number of the Bill agent.Phone number of the Bill agent. |
| emailBillAgent | string | Email address of the Bill agent.Email address of the Bill agent. |
| websiteBillAgent | string | Website address of the Bill agent.Website address of the Bill agent. |
| titleBillPublication | string | Title of the Bill publication.Title of the Bill publication. |
| publicationTypeBillPublication | object | Type of the Bill publication.Type of the Bill publication. |
| displayDateBillPublication | string (date-time) | Date the publication is displayed as being published.Date the publication is displayed as being published. |
| linksBillPublication | array<object> | List of links associated with the publication.List of links associated with the publication. |
| filesBillPublication | array<object> | List of files associated with the publication.List of files associated with the publication. |
| publicationsBillPublicationList | array<object> | List of publications associated with the Bill.List of publications associated with the Bill. |
| sessionIdBillStageDetails | integer (int32) | Identifier of the parliamentary session for the stage.Identifier of the parliamentary session for the stage. |
| descriptionBillStageDetails | string | Description of the Bill stage.Description of the Bill stage. |
| abbreviationBillStageDetails | string | Abbreviated name of the Bill stage.Abbreviated name of the Bill stage. |
| stageSittingsBillStageDetails | array<object> | List of sittings held for the Bill stage.List of sittings held for the Bill stage. |
| committeeBillStageDetails | object | Committee associated with the Bill stage.Committee associated with the Bill stage. |
| nextStageBillStageIdBillStageDetails | integer (int32) | Identifier of the following Bill stage.Identifier of the following Bill stage. |
| previousStageBillStageIdBillStageDetails | integer (int32) | Identifier of the preceding Bill stage.Identifier of the preceding Bill stage. |
| hasMotionsBillStageDetails | boolean | Whether the Bill stage has associated motions.Whether the Bill stage has associated motions. |
| sittingsBillStagePublicationList | array<object> | List of sittings associated with the Bill stage's publications.List of sittings associated with the Bill stage's publications. |
| sittingIdBillStageSittingPublicationList | integer (int32) | Identifier of a specific sitting.Identifier of a specific sitting. |
| categoryBillType | object | Category classification of the Bill type.Category classification of the Bill type. |
Schema captured from openapi 23 days ago.
Verification Status
Using the API
Configuration
- Base URL
- https://bills-api.parliament.uk
- Version
- v1
- Format
- openapi
- Endpoints
- 21
Try the API
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/AmendmentsReturns a list of amendments.
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments/{amendmentId}Returns an amendment.
GET
/api/v1/Bills/{billId}/NewsArticlesReturns a list of news articles for a Bill.
GET
/api/v1/BillTypesReturns a list of Bill types.
GET
/api/v1/BillsReturns a list of Bills.
Requests are proxied through our servers. Only GET endpoints are testable.
Endpoints (21)
/api21 endpoints
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/AmendmentsReturns a list of amendments.
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments/{amendmentId}Returns an amendment.
GET
/api/v1/Bills/{billId}/NewsArticlesReturns a list of news articles for a Bill.
GET
/api/v1/BillTypesReturns a list of Bill types.
GET
/api/v1/BillsReturns a list of Bills.
GET
/api/v1/Bills/{billId}Return a Bill.
GET
/api/v1/Bills/{billId}/Stages/{billStageId}Returns a Bill stage.
GET
/api/v1/Bills/{billId}/StagesReturns all Bill stages.
GET
/api/v1/Publications/{publicationId}/Documents/{documentId}Return information on a document.
GET
/api/v1/Publications/{publicationId}/Documents/{documentId}/DownloadReturn a document.
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/PingPongItemsReturns a list of motions or amendments.
GET
/api/v1/Bills/{billId}/Stages/{billStageId}/PingPongItems/{pingPongItemId}Returns amendment or motion detail.
GET
/api/v1/PublicationTypesReturns a list of publication types.
GET
/api/v1/Bills/{billId}/PublicationsReturn a list of Bill publications.
GET
/api/v1/Bills/{billId}/Stages/{stageId}/PublicationsReturn a list of Bill stage publications.
GET
/api/v1/Rss/allbills.rssReturns an Rss feed of all Bills.
GET
/api/v1/Rss/publicbills.rssReturns an Rss feed of public Bills.
GET
/api/v1/Rss/privatebills.rssReturns an Rss feed of private Bills.
GET
/api/v1/Rss/Bills/{id}.rssReturns an Rss feed of a certain Bill.
GET
/api/v1/SittingsReturns a list of Sittings.
GET
/api/v1/StagesReturns a list of Bill stages.
Query examples
curl -s 'https://bills-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.