APIHub
Back to Explore

Bills API

The Bills API provides programmatic access to legislative bill data, enabling retrieval of individual bills and searchable bill listings together with related details such as stages, amendments, publications, news articles, bill and publication types, and RSS feeds for public, private, or all bills.

Open Data
none
HTTPS
CORS: Unknown
Description enriched
Visit official documentation

Latency

646ms p95

Uptime

100.0% 30d

Playground

Verified

live

Endpoints

REST · JSON
GET

/api/v1/Bills/{billId}

Return a Bill.

  • billId (path, required) — Bill with ID specified
GET

/api/v1/Bills/{billId}/NewsArticles

Returns a list of news articles for a Bill.

  • billId (path, required)
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Bills/{billId}/Publications

Return a list of Bill publications.

  • billId (path, required) — Publications relating to Bill with Bill ID specified
GET

/api/v1/Bills/{billId}/Stages

Returns all Bill stages.

  • billId (path, required) — Stages relating to a Bill with Bill ID specified
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Bills/{billId}/Stages/{billStageId}

Returns a Bill stage.

  • billId (path, required) — Bill stage relating to Bill with Bill ID specified
  • billStageId (path, required) — Bill stage with ID specified
GET

/api/v1/BillTypes

Returns a list of Bill types.

  • Category (query)
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Bills

Returns a list of Bills.

  • SearchTerm (query)
  • Session (query)
  • CurrentHouse (query)
  • OriginatingHouse (query)
  • MemberId (query)
  • DepartmentId (query)
  • BillStage (query)
  • BillStagesExcluded (query)
  • IsDefeated (query)
  • IsWithdrawn (query)
  • BillType (query)
  • SortOrder (query)
  • BillIds (query)
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments

Returns a list of amendments.

  • billId (path, required) — Amendments relating to a Bill with Bill ID specified
  • billStageId (path, required) — Amendments relating to a Bill stage with Bill stage ID specified
  • SearchTerm (query)
  • Decision (query)
  • MemberId (query)
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments/{amendmentId}

Returns an amendment.

  • billId (path, required) — Amendment relating to a bill with bill ID specified
  • billStageId (path, required) — Amendment relating to a bill stage with bill stage ID specified
  • amendmentId (path, required) — Amendment with amendment ID specified
GET

/api/v1/Bills/{billId}/Stages/{stageId}/Publications

Return a list of Bill stage publications.

  • billId (path, required)
  • stageId (path, required)
GET

/api/v1/PublicationTypes

Returns a list of publication types.

  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Publications/{publicationId}/Documents/{documentId}

Return information on a document.

  • publicationId (path, required) — Document with publication Id specified
  • documentId (path, required) — Document with Id specified
GET

/api/v1/Publications/{publicationId}/Documents/{documentId}/Download

Return a document.

  • publicationId (path, required) — Document with publication Id specified
  • documentId (path, required) — Document with Id specified
GET

/api/v1/Rss/Bills/{id}.rss

Returns an Rss feed of a certain Bill.

  • id (path, required) — Id of Bill
GET

/api/v1/Rss/allbills.rss

Returns an Rss feed of all Bills.

GET

/api/v1/Rss/privatebills.rss

Returns an Rss feed of private Bills.

GET

/api/v1/Rss/publicbills.rss

Returns an Rss feed of public Bills.

GET

/api/v1/Sittings

Returns a list of Sittings.

  • House (query)
  • DateFrom (query)
  • DateTo (query)
  • Skip (query, offset)
  • Take (query)
GET

/api/v1/Stages

Returns a list of Bill stages.

  • Skip (query, offset)
  • Take (query)

19 endpoints auto-detected

curl -X GET \
  "https://bills-api.parliament.uk/api/v1/Bills/{billId}"

bills-api.parliament.uk · HTTPS only