Search bills
search_billsSearch and list bills/resolutions using filters such as Congress, type, sponsor, date range, or latest action text. Results are paginated with adjustable page size.
Instructions
Search and list bills/resolutions with flexible filters. Use this for questions like 'bills recently introduced in the House', 'bills that became law recently' (latestActionContains: 'Became Public Law'), or 'bills that passed the Senate' (latestActionContains: 'Passed Senate'). Results are paginated; increase 'limit' (max 50) for more.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| congress | No | Congress number, e.g. 119 for the 119th Congress. | |
| billType | No | Bill type code: HR, S, HJRES, SJRES, HCONRES, SCONRES, HRES, SRES. | |
| originChamber | No | Chamber where the bill originated. | |
| titleContains | No | Case-sensitive substring to match within the bill title. | |
| latestActionContains | No | Substring to match within the latest action text. Examples: 'Became Public Law', 'Passed House', 'Passed Senate', 'Referred to the Committee'. | |
| introducedAfter | No | Only bills introduced on/after this date (YYYY-MM-DD). | |
| introducedBefore | No | Only bills introduced on/before this date (YYYY-MM-DD). | |
| sponsorState | No | Two-letter state code of the bill sponsor, e.g. 'CA'. | |
| sponsorParty | No | Party of the bill sponsor, e.g. 'R', 'D', 'I'. | |
| sponsorBioguideId | No | Bioguide ID of the bill sponsor. | |
| sortBy | No | Field to sort by. Default: introducedDate. | |
| sortOrder | No | Sort direction. Default: DESC (newest first). | |
| limit | No | Max results to return (1-50). Default 10. | |
| after | No | Relay pagination cursor. Pass the `pageInfo.endCursor` from a previous result to fetch the next page. |