Register record·API·GB·GOVERNMENTVERIFIED · checked 7h ago
Trust score
How is this computed?0
good
Composite of 5 axes from our methodology (proof-based officialness, live verification, metadata completeness, license clarity, agent readiness).
- Officialnessweight 25%40/100
40/100 from 5 proof signals (domain / portal-backlink / GitHub-org / reciprocal / policy).
- Availabilityweight 25%100/100
Latest verification succeeded.
- Metadata completenessweight 20%90/100
9 of 10 recommended metadata fields populated.
- License clarityweight 15%50/100
License info not yet tracked for APIs (datasets only).
- Agent readinessweight 15%70/100
OpenAPI spec URL declared · Spec format known (openapi) · Homepage URL present · Topic tags assigned
Official Proof
Public Sector APIProof Evidence
official domain (parliament.uk)
Data schema (111 fields)
Filterable via the API (31)
billIdbillStageIdSearchTermAmendmentNumberDecisionMemberIdSkipTakeamendmentIdCategorySessionCurrentHouseOriginatingHouseDepartmentIdBillStageBillStagesExcludedIsDefeatedIsWithdrawnBillTypeSortOrderBillIdsIsInAmendableStagepublicationIddocumentIdpingPongItemIddatestageIdidHouseDateFromDateTo
| Field | Type | Description |
|---|---|---|
| billId | integer (int32) | Amendments relating to a Bill with Bill ID specified |
| billStageId | integer (int32) | Amendments relating to a Bill stage with Bill stage ID specified |
| SearchTerm | string | — |
| AmendmentNumber | string | — |
| Decision | string | — |
| MemberId | integer (int32) | — |
| Skip | integer (int32) | — |
| Take | integer (int32) | — |
| amendmentId | integer (int32) | Amendment with amendment ID specified |
| Category | string | — |
| Session | integer (int32) | — |
| CurrentHouse | string | — |
| OriginatingHouse | string | — |
| DepartmentId | integer (int32) | — |
| BillStage | array | — |
| BillStagesExcluded | array | — |
| IsDefeated | boolean | — |
| IsWithdrawn | boolean | — |
| BillType | array | — |
| SortOrder | string | — |
| BillIds | array | — |
| IsInAmendableStage | boolean | — |
| publicationId | integer (int32) | Document with publication Id specified |
| documentId | integer (int32) | Document with Id specified |
| pingPongItemId | integer (int32) | Motions or amendments with ping pong item ID specified |
| date | string (date-time) | Publications with a display date matching this date. |
| stageId | integer (int32) | — |
| id | integer (int32) | Id of Bill |
| House | string | — |
| DateFrom | string (date-time) | — |
| DateTo | string (date-time) | — |
| statusIndicatorAmendmentDetail | string | — |
| decisionAmendmentDetail | object | — |
| decisionExplanationAmendmentDetail | string | — |
| sponsorsAmendmentDetail | array<object> | — |
| amendmentTypeAmendmentDetail | object | — |
| clauseAmendmentDetail | integer (int32) | — |
| scheduleAmendmentDetail | integer (int32) | — |
| pageNumberAmendmentDetail | integer (int32) | — |
| lineNumberAmendmentDetail | integer (int32) | — |
| amendmentPositionAmendmentDetail | string | — |
| marshalledListTextAmendmentDetail | string | — |
| dNumAmendmentDetail | string | — |
| amendmentLinesAmendmentDetail | array<object> | — |
| explanatoryTextPrefixAmendmentDetail | string | — |
| explanatoryTextAmendmentDetail | string | — |
| amendmentNoteAmendmentDetail | string | — |
| amendmentLocationAmendmentDetail | string | — |
| mainHeaderAmendmentDetail | string | — |
| typeAmendmentDetailMotionDetailPingPongItem | object | — |
| amendmentAmendmentDetailMotionDetailPingPongItem | object | — |
| motionAmendmentDetailMotionDetailPingPongItem | object | — |
| textAmendmentGroup | array<object> | — |
| amendmentsAmendmentGroup | array<object> | — |
| sortOrderAmendmentGroup | integer (int32) | — |
| indentationAmendmentLine | integer (int32) | — |
| hangingIndentationAmendmentLine | string | — |
| isImageAmendmentLine | boolean | — |
| imageTypeAmendmentLine | string | — |
| memberIdAmendmentMember | integer (int32) | — |
| nameAmendmentMember | string | — |
| partyAmendmentMember | string | — |
| partyColourAmendmentMember | string | — |
| houseAmendmentMember | object | — |
| memberPhotoAmendmentMember | string | — |
| memberPageAmendmentMember | string | — |
| memberFromAmendmentMember | string | — |
| isLeadAmendmentMember | boolean | — |
| summaryTextAmendmentSearchItem | array<string> | — |
| itemsAmendmentSearchItemSearchResult | array<object> | — |
| totalResultsAmendmentSearchItemSearchResult | integer (int32) | — |
| itemsPerPageAmendmentSearchItemSearchResult | integer (int32) | — |
| shortTitleBill | string | — |
| formerShortTitleBill | string | — |
| currentHouseBill | object | — |
| originatingHouseBill | object | — |
| lastUpdateBill | string (date-time) | — |
| billWithdrawnBill | string (date-time) | — |
| isDefeatedBill | boolean | — |
| billTypeIdBill | integer (int32) | — |
| introducedSessionIdBill | integer (int32) | — |
| includedSessionIdsBill | array<integer (int32)> | — |
| isActBill | boolean | — |
| currentStageBill | object | — |
| longTitleBill | string | — |
| summaryBill | string | — |
| promotersBill | array<object> | — |
| petitioningPeriodBill | string | — |
| petitionInformationBill | string | — |
| agentBill | object | — |
| addressBillAgent | string | — |
| phoneNoBillAgent | string | — |
| emailBillAgent | string | — |
| websiteBillAgent | string | — |
| titleBillPublication | string | — |
| publicationTypeBillPublication | object | — |
| displayDateBillPublication | string (date-time) | — |
| linksBillPublication | array<object> | — |
| filesBillPublication | array<object> | — |
| publicationsBillPublicationList | array<object> | — |
| sessionIdBillStageDetails | integer (int32) | — |
| descriptionBillStageDetails | string | — |
| abbreviationBillStageDetails | string | — |
| stageSittingsBillStageDetails | array<object> | — |
| committeeBillStageDetails | object | — |
| nextStageBillStageIdBillStageDetails | integer (int32) | — |
| previousStageBillStageIdBillStageDetails | integer (int32) | — |
| hasMotionsBillStageDetails | boolean | — |
| sittingsBillStagePublicationList | array<object> | — |
| sittingIdBillStageSittingPublicationList | integer (int32) | — |
| categoryBillType | object | — |
Schema captured from openapi 2 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.
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.