For Agents
Search UK Bills, retrieve stages and amendments, access publications and documents for legislative tracking and research.
Use for: I need to find all Bills introduced this session, Track amendments to the Finance Bill, Get the latest publication for a Bill, Find Bills sponsored by a specific MP
Not supported: Does not include voting records (use Commons Votes or Lords Votes APIs), member biographies (use Members API), or Hansard transcripts — use only for Bill lifecycle, amendments, and publication metadata.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the UK Parliament Bills API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with UK Parliament Bills API API.
Search Bills by session, house (Commons/Lords), originating house, member, department, stage, type, and keywords
Retrieve Bill details including title, session, current stage, sponsors, and timeline
List Bill stages and retrieve stage details with sitting dates and publications
Search and retrieve amendments with sponsor information, text, and decision outcomes
GET STARTED
UK Parliament Bills API provides comprehensive access to information about legislative Bills, their parliamentary stages, amendments, publications, and associated news articles. The API enables searching and filtering Bills by session, house, member, department, stage, type, and keywords, retrieving Bill details and stage information, listing and searching amendments with decisions and sponsors, accessing publications and documents with download capability, querying Bill types and publication types, and subscribing to RSS feeds for Bill updates. Public and unauthenticated access.
Access Bill publications grouped by stage with document metadata and download links
Download publication documents as PDFs or other formats
Query Bill types (public, private, hybrid) and publication types
Retrieve Bill news articles and media coverage
Subscribe to RSS feeds for all Bills, public Bills, private Bills, or specific Bills
Patterns agents use UK Parliament Bills API API for, with concrete tasks.
★ Legislative Tracking Dashboard
Build dashboards for policy analysts, lobbyists, or civic organizations to monitor Bills of interest. GET /api/v1/Bills with filters for Session, BillStage, or DepartmentId returns matching Bills. Combine with GET /api/v1/Bills/{billId}/Stages to show progression and GET /api/v1/Bills/{billId}/Stages/{stageId}/Amendments to track proposed changes. RSS feeds provide real-time updates.
GET /api/v1/Bills?Session={sessionId}&BillStage={stageIds} for Bills of interest, then GET /api/v1/Bills/{billId} for details and /api/v1/Bills/{billId}/Stages for stage history.
Amendment Research and Analysis
Legal researchers and policy teams use the API to study amendment patterns and voting outcomes. GET /api/v1/Bills/{billId}/Stages/{stageId}/Amendments with Decision and MemberId filters identifies amendments by sponsor or outcome. GET /api/v1/Bills/{billId}/Stages/{stageId}/Amendments/{amendmentId} retrieves full amendment text and sponsor details.
GET /api/v1/Bills/{billId}/Stages/{stageId}/Amendments?MemberId={memberId} to find amendments by a member, or ?Decision=Agreed to filter by outcome.
Document Archiving and Research
Academic and media researchers access Bill publications and documents for historical analysis. GET /api/v1/Bills/{billId}/Publications lists all publications by stage. GET /api/v1/Publications/{publicationId}/Documents/{documentId} retrieves document metadata, and GET /api/v1/Publications/{publicationId}/Documents/{documentId}/Download fetches the PDF or file.
GET /api/v1/Bills/{billId}/Publications to list publications, then GET /api/v1/Publications/{pubId}/Documents/{docId}/Download to retrieve the PDF.
14 endpoints — uk parliament bills api provides comprehensive access to information about legislative bills, their parliamentary stages, amendments, publications, and associated news articles.
METHOD
PATH
DESCRIPTION
/api/v1/Bills
Search and filter Bills
/api/v1/Bills/{billId}
Get Bill details
/api/v1/Bills/{billId}/Stages
List Bill stages
/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments
List amendments for a Bill stage
/api/v1/Bills/{billId}/Publications
List Bill publications
/api/v1/Publications/{publicationId}/Documents/{documentId}/Download
Download publication document
/api/v1/Bills
Search and filter Bills
/api/v1/Bills/{billId}
Get Bill details
/api/v1/Bills/{billId}/Stages
List Bill stages
/api/v1/Bills/{billId}/Stages/{billStageId}/Amendments
List amendments for a Bill stage
/api/v1/Bills/{billId}/Publications
List Bill publications
Three things that make agents converge on Jentic-routed access.
Credential isolation
No credentials required — the Bills API is public and open.
Intent-based discovery
Agents search by intent such as 'find UK Bills' or 'track bill amendments' and Jentic returns matching endpoints with schemas and examples.
Time to first call
Direct Bills API integration: 1-2 days to model Bills, stages, amendments, and publications. Through Jentic: under 1 hour.
Alternatives and complements available in the Jentic catalogue.
Commons Votes API
Commons Votes tracks division voting on Bills and amendments while Bills API tracks Bill metadata and stages.
Use Bills API for Bill lifecycle and amendments, Commons Votes for how MPs voted on those amendments.
Lords Votes API
Lords Votes tracks House of Lords division voting while Bills API tracks Bill progression through both Houses.
Use Bills API for Bill stages and Lords Votes for how Peers voted on Bills in the Lords.
Specific to using UK Parliament Bills API API through Jentic.
Does the Bills API require authentication?
No. The Bills API is public and does not require authentication or API keys. All endpoints are freely accessible for research and civic use.
Can I track amendments to a specific Bill?
Yes. GET /api/v1/Bills/{billId}/Stages/{billStageId}/Amendments returns all amendments for a stage. Filter by MemberId to see amendments by a specific MP or by Decision to filter by outcome (Agreed, Disagreed, Withdrawn, Not moved).
How do I download Bill documents?
First GET /api/v1/Bills/{billId}/Publications to list publications, then GET /api/v1/Publications/{publicationId}/Documents/{documentId}/Download to retrieve the PDF or file.
/api/v1/Publications/{publicationId}/Documents/{documentId}/Download
Download publication document