{"id":"0fa42881-7a6c-4f7e-b632-ec4f8283eb0d","type":"API","name":"Bills API","slug":"bills-api","description":"API to get and search for information regarding Bills, their stages, associated amendments and publications.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.parliament.uk","docs_url":null,"repo_url":"https://bills-api.parliament.uk/swagger/v1/swagger.json","status":"ACTIVE","verification_state":"VERIFIED","tags":["legislation"],"logo_url":"https://www.google.com/s2/favicons?sz=64&domain=parliament.uk","primary_source_url":"https://bills-api.parliament.uk/swagger/v1/swagger.json","extraction_confidence":"0.70","created_at":"2026-01-01T19:42:15.956Z","updated_at":"2026-07-05T07:05:13.848Z","last_verified_at":"2026-07-05T07:05:13.848Z","deprecated_at":null,"ranking_score":67,"last_ranked_at":"2026-07-03T22:21:06.572Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":"2026-07-05T04:01:48.981Z","search_vector":"'amend':15B 'api':2A,3B 'associ':14B 'bill':1A,11B 'get':5B 'inform':9B 'legisl':18C 'public':17B 'regard':10B 'search':7B 'stage':13B","popularity_score":"0.0000","maintenance_score":"0.5000","institution_id":"80926881-de89-4d9e-a1c5-f2393d25dac7","institution_type":"GOVERNMENT","country_code":"GB","official_confidence":40,"proof_summary":"official domain (parliament.uk)","source_seed_url":null,"is_public_sector":true,"published_at":"2026-01-01T19:42:15.956Z","geographic_scope":"NATIONAL","api_details":{"id":"3ea4da34-eda4-43f4-9bf0-5fb47f389e77","entry_id":"0fa42881-7a6c-4f7e-b632-ec4f8283eb0d","base_url":"https://bills-api.parliament.uk","openapi_url":"https://bills-api.parliament.uk/swagger/v1/swagger.json","graphql_url":null,"api_version":"v1","spec_format":"openapi","endpoints_count":21,"endpoints":[{"path":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments","method":"GET","description":"Returns a list of amendments."},{"path":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments/{amendmentId}","method":"GET","description":"Returns an amendment."},{"path":"/api/v1/Bills/{billId}/NewsArticles","method":"GET","description":"Returns a list of news articles for a Bill."},{"path":"/api/v1/BillTypes","method":"GET","description":"Returns a list of Bill types."},{"path":"/api/v1/Bills","method":"GET","description":"Returns a list of Bills."},{"path":"/api/v1/Bills/{billId}","method":"GET","description":"Return a Bill."},{"path":"/api/v1/Bills/{billId}/Stages/{billStageId}","method":"GET","description":"Returns a Bill stage."},{"path":"/api/v1/Bills/{billId}/Stages","method":"GET","description":"Returns all Bill stages."},{"path":"/api/v1/Publications/{publicationId}/Documents/{documentId}","method":"GET","description":"Return information on a document."},{"path":"/api/v1/Publications/{publicationId}/Documents/{documentId}/Download","method":"GET","description":"Return a document."},{"path":"/api/v1/Bills/{billId}/Stages/{billStageId}/PingPongItems","method":"GET","description":"Returns a list of motions or amendments."},{"path":"/api/v1/Bills/{billId}/Stages/{billStageId}/PingPongItems/{pingPongItemId}","method":"GET","description":"Returns amendment or motion detail."},{"path":"/api/v1/PublicationTypes","method":"GET","description":"Returns a list of publication types."},{"path":"/api/v1/Bills/{billId}/Publications","method":"GET","description":"Return a list of Bill publications."},{"path":"/api/v1/Bills/{billId}/Stages/{stageId}/Publications","method":"GET","description":"Return a list of Bill stage publications."},{"path":"/api/v1/Rss/allbills.rss","method":"GET","description":"Returns an Rss feed of all Bills."},{"path":"/api/v1/Rss/publicbills.rss","method":"GET","description":"Returns an Rss feed of public Bills."},{"path":"/api/v1/Rss/privatebills.rss","method":"GET","description":"Returns an Rss feed of private Bills."},{"path":"/api/v1/Rss/Bills/{id}.rss","method":"GET","description":"Returns an Rss feed of a certain Bill."},{"path":"/api/v1/Sittings","method":"GET","description":"Returns a list of Sittings."},{"path":"/api/v1/Stages","method":"GET","description":"Returns a list of Bill stages."}],"rate_limit_info":null,"free_tier_limits":null,"ping_url":null,"created_at":"2026-01-01T19:42:16.126Z","updated_at":"2026-01-01T19:42:16.126Z"},"dataset_details":null,"latest_check":{"id":"38f7bad3-857c-41e3-8e55-3c263366b281","entry_id":"0fa42881-7a6c-4f7e-b632-ec4f8283eb0d","status":"VERIFIED","last_checked_at":"2026-07-05T07:05:13.679Z","p50_latency_ms":410,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-06-08T12:34:16.144Z","updated_at":"2026-07-05T07:05:13.679Z","consecutive_successes":17},"data_profile":{"id":"9bc0a765-d231-4d6f-82e6-7cbfa37ac70c","entry_id":"0fa42881-7a6c-4f7e-b632-ec4f8283eb0d","profile_source":"openapi","profile_kind":"dataset","dataset_id":null,"fields":[{"name":"billId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments","filterable":true,"description":"Amendments relating to a Bill with Bill ID specified"},{"name":"billStageId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments","filterable":true,"description":"Amendments relating to a Bill stage with Bill stage ID specified"},{"name":"SearchTerm","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"AmendmentNumber","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments","filterable":true,"description":null},{"name":"Decision","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments","filterable":true,"description":null},{"name":"MemberId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"Skip","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"query","container":"/api/v1/BillTypes","filterable":true,"description":null},{"name":"Take","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"query","container":"/api/v1/BillTypes","filterable":true,"description":null},{"name":"amendmentId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments/{amendmentId}","filterable":true,"description":"Amendment with amendment ID specified"},{"name":"Category","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/BillTypes","filterable":true,"description":null},{"name":"Session","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"CurrentHouse","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"OriginatingHouse","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"DepartmentId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"BillStage","role":"parameter","type":"array","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"BillStagesExcluded","role":"parameter","type":"array","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"IsDefeated","role":"parameter","type":"boolean","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"IsWithdrawn","role":"parameter","type":"boolean","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"BillType","role":"parameter","type":"array","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"SortOrder","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"BillIds","role":"parameter","type":"array","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"IsInAmendableStage","role":"parameter","type":"boolean","label":null,"param_in":"query","container":"/api/v1/Bills","filterable":true,"description":null},{"name":"publicationId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Publications/{publicationId}/Documents/{documentId}","filterable":true,"description":"Document with publication Id specified"},{"name":"documentId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Publications/{publicationId}/Documents/{documentId}","filterable":true,"description":"Document with Id specified"},{"name":"pingPongItemId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Bills/{billId}/Stages/{billStageId}/PingPongItems/{pingPongItemId}","filterable":true,"description":"Motions or amendments with ping pong item ID specified"},{"name":"date","role":"parameter","type":"string (date-time)","label":null,"format":"date-time","param_in":"query","container":"/api/v1/Publications","filterable":true,"description":"Publications with a display date matching this date."},{"name":"stageId","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Bills/{billId}/Stages/{stageId}/Publications","filterable":true,"description":null},{"name":"id","role":"parameter","type":"integer (int32)","label":null,"format":"int32","param_in":"path","required":true,"container":"/api/v1/Rss/Bills/{id}.rss","filterable":true,"description":"Id of Bill"},{"name":"House","role":"parameter","type":"string","label":null,"param_in":"query","container":"/api/v1/Sittings","filterable":true,"description":null},{"name":"DateFrom","role":"parameter","type":"string (date-time)","label":null,"format":"date-time","param_in":"query","container":"/api/v1/Sittings","filterable":true,"description":null},{"name":"DateTo","role":"parameter","type":"string (date-time)","label":null,"format":"date-time","param_in":"query","container":"/api/v1/Sittings","filterable":true,"description":null},{"name":"statusIndicator","type":"string","label":"AmendmentDetail","description":null},{"name":"decision","type":"object","label":"AmendmentDetail","description":null},{"name":"decisionExplanation","type":"string","label":"AmendmentDetail","description":null},{"name":"sponsors","type":"array<object>","label":"AmendmentDetail","description":null},{"name":"amendmentType","type":"object","label":"AmendmentDetail","description":null},{"name":"clause","type":"integer (int32)","label":"AmendmentDetail","format":"int32","description":null},{"name":"schedule","type":"integer (int32)","label":"AmendmentDetail","format":"int32","description":null},{"name":"pageNumber","type":"integer (int32)","label":"AmendmentDetail","format":"int32","description":null},{"name":"lineNumber","type":"integer (int32)","label":"AmendmentDetail","format":"int32","description":null},{"name":"amendmentPosition","type":"string","label":"AmendmentDetail","description":null},{"name":"marshalledListText","type":"string","label":"AmendmentDetail","description":null},{"name":"dNum","type":"string","label":"AmendmentDetail","description":null},{"name":"amendmentLines","type":"array<object>","label":"AmendmentDetail","description":null},{"name":"explanatoryTextPrefix","type":"string","label":"AmendmentDetail","description":null},{"name":"explanatoryText","type":"string","label":"AmendmentDetail","description":null},{"name":"amendmentNote","type":"string","label":"AmendmentDetail","description":null},{"name":"amendmentLocation","type":"string","label":"AmendmentDetail","description":null},{"name":"mainHeader","type":"string","label":"AmendmentDetail","description":null},{"name":"type","type":"object","label":"AmendmentDetailMotionDetailPingPongItem","description":null},{"name":"amendment","type":"object","label":"AmendmentDetailMotionDetailPingPongItem","description":null},{"name":"motion","type":"object","label":"AmendmentDetailMotionDetailPingPongItem","description":null},{"name":"text","type":"array<object>","label":"AmendmentGroup","description":null},{"name":"amendments","type":"array<object>","label":"AmendmentGroup","description":null},{"name":"sortOrder","type":"integer (int32)","label":"AmendmentGroup","format":"int32","description":null},{"name":"indentation","type":"integer (int32)","label":"AmendmentLine","format":"int32","description":null},{"name":"hangingIndentation","type":"string","label":"AmendmentLine","description":null},{"name":"isImage","type":"boolean","label":"AmendmentLine","description":null},{"name":"imageType","type":"string","label":"AmendmentLine","description":null},{"name":"memberId","type":"integer (int32)","label":"AmendmentMember","format":"int32","description":null},{"name":"name","type":"string","label":"AmendmentMember","description":null},{"name":"party","type":"string","label":"AmendmentMember","description":null},{"name":"partyColour","type":"string","label":"AmendmentMember","description":null},{"name":"house","type":"object","label":"AmendmentMember","description":null},{"name":"memberPhoto","type":"string","label":"AmendmentMember","description":null},{"name":"memberPage","type":"string","label":"AmendmentMember","description":null},{"name":"memberFrom","type":"string","label":"AmendmentMember","description":null},{"name":"isLead","type":"boolean","label":"AmendmentMember","description":null},{"name":"summaryText","type":"array<string>","label":"AmendmentSearchItem","description":null},{"name":"items","type":"array<object>","label":"AmendmentSearchItemSearchResult","description":null},{"name":"totalResults","type":"integer (int32)","label":"AmendmentSearchItemSearchResult","format":"int32","description":null},{"name":"itemsPerPage","type":"integer (int32)","label":"AmendmentSearchItemSearchResult","format":"int32","description":null},{"name":"shortTitle","type":"string","label":"Bill","description":null},{"name":"formerShortTitle","type":"string","label":"Bill","description":null},{"name":"currentHouse","type":"object","label":"Bill","description":null},{"name":"originatingHouse","type":"object","label":"Bill","description":null},{"name":"lastUpdate","type":"string (date-time)","label":"Bill","format":"date-time","description":null},{"name":"billWithdrawn","type":"string (date-time)","label":"Bill","format":"date-time","description":null},{"name":"isDefeated","type":"boolean","label":"Bill","description":null},{"name":"billTypeId","type":"integer (int32)","label":"Bill","format":"int32","description":null},{"name":"introducedSessionId","type":"integer (int32)","label":"Bill","format":"int32","description":null},{"name":"includedSessionIds","type":"array<integer (int32)>","label":"Bill","description":null},{"name":"isAct","type":"boolean","label":"Bill","description":null},{"name":"currentStage","type":"object","label":"Bill","description":null},{"name":"longTitle","type":"string","label":"Bill","description":null},{"name":"summary","type":"string","label":"Bill","description":null},{"name":"promoters","type":"array<object>","label":"Bill","description":null},{"name":"petitioningPeriod","type":"string","label":"Bill","description":null},{"name":"petitionInformation","type":"string","label":"Bill","description":null},{"name":"agent","type":"object","label":"Bill","description":null},{"name":"address","type":"string","label":"BillAgent","description":null},{"name":"phoneNo","type":"string","label":"BillAgent","description":null},{"name":"email","type":"string","label":"BillAgent","description":null},{"name":"website","type":"string","label":"BillAgent","description":null},{"name":"title","type":"string","label":"BillPublication","description":null},{"name":"publicationType","type":"object","label":"BillPublication","description":null},{"name":"displayDate","type":"string (date-time)","label":"BillPublication","format":"date-time","description":null},{"name":"links","type":"array<object>","label":"BillPublication","description":null},{"name":"files","type":"array<object>","label":"BillPublication","description":null},{"name":"publications","type":"array<object>","label":"BillPublicationList","description":null},{"name":"sessionId","type":"integer (int32)","label":"BillStageDetails","format":"int32","description":null},{"name":"description","type":"string","label":"BillStageDetails","description":null},{"name":"abbreviation","type":"string","label":"BillStageDetails","description":null},{"name":"stageSittings","type":"array<object>","label":"BillStageDetails","description":null},{"name":"committee","type":"object","label":"BillStageDetails","description":null},{"name":"nextStageBillStageId","type":"integer (int32)","label":"BillStageDetails","format":"int32","description":null},{"name":"previousStageBillStageId","type":"integer (int32)","label":"BillStageDetails","format":"int32","description":null},{"name":"hasMotions","type":"boolean","label":"BillStageDetails","description":null},{"name":"sittings","type":"array<object>","label":"BillStagePublicationList","description":null},{"name":"sittingId","type":"integer (int32)","label":"BillStageSittingPublicationList","format":"int32","description":null},{"name":"category","type":"object","label":"BillType","description":null}],"field_count":111,"sample_records":null,"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://bills-api.parliament.uk/swagger/v1/swagger.json","curl":"curl -s 'https://bills-api.parliament.uk/swagger/v1/swagger.json' -H 'Accept: application/json'","label":"OpenAPI spec","method":"GET","description":"Machine-readable API description (use it to generate clients)."},{"url":"https://bills-api.parliament.uk/api/v1/BillTypes","curl":"curl -s 'https://bills-api.parliament.uk/api/v1/BillTypes' -H 'Accept: application/json'","label":"Returns a list of Bill types.","method":"GET","description":"Returns a list of Bill types."}],"status":"partial","error_message":null,"profiled_at":"2026-07-03T19:13:17.485Z","run_id":"cedd5723-0a1e-4426-bd77-cd3bea600fa3","created_at":"2026-06-12T19:03:49.798Z","updated_at":"2026-07-03T19:13:17.485Z"},"limits":[]}