Get Bill Detail
bills_get_billRead-onlyIdempotent
Given a bill ID, retrieves full bill details: sponsors, current stage, long title, summary, and Royal Assent date. Summary length is adjustable via max_summary_chars parameter.
Instructions
USE THIS TOOL WHEN you have a bill_id (from bills_search_bills) and want the full detail.
Returns sponsors, current stage, long title, summary, and Royal Assent date if enacted. Summary text is capped per max_summary_chars — check summary_truncated in the response.
AFTER calling, use parliament_search_hansard(query=bill_short_title) to find the bill's parliamentary debates, or bills_search_bills with a related keyword for adjacent bills.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bill_id | Yes | Bill ID from bills_search_bills results. | |
| max_summary_chars | No | Maximum characters of the bill summary text to return. Default 5,000 (~1,250 tokens) covers most bills. Raise for substantive government bills (Finance Act, Levelling-up) whose summary runs longer. Check summary_truncated in the response to see if it was cut. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Bill ID | |
| short_title | Yes | Short title of the bill | |
| long_title | No | Full long title | |
| summary | No | Bill summary text, possibly truncated per max_summary_chars. Check summary_truncated and summary_original_length for full-text info. | |
| summary_truncated | No | True if summary was cut to fit max_summary_chars | |
| summary_original_length | No | Original summary length in characters before any truncation | |
| current_house | No | House where the bill currently sits | |
| originating_house | No | House where the bill was introduced | |
| current_stage | No | Current legislative stage | |
| sponsors | No | Bill sponsors | |
| stages | No | Legislative stages the bill has passed through | |
| is_act | No | Whether the bill has received Royal Assent | |
| royal_assent_date | No | Date Royal Assent was given | |
| url | Yes | Parliament URL for this bill |