GET
/api/v1/bills
Search and filter legislative bills. Supports filtering by status, chamber, jurisdiction, and topic.
Parameters
| Parameter | Type | Description |
|---|---|---|
jurisdiction | string | Jurisdiction ID or name |
topic | string | Topic keyword |
status | string | Bill status (in_committee, passed_chamber, signed) |
chamber | string | senate or house |
limit | number | Results per page (default: 20, max: 100) |
offset | number | Skip N results |
Code Samples
curl
curl "https://federalstatelaw.com/api/v1/bills?jurisdiction=federal&status=in_committee&limit=5"
JavaScript (fetch)
const res = await fetch(
"https://federalstatelaw.com/api/v1/bills?jurisdiction=federal&status=in_committee&limit=5"
);
const { data, meta } = await res.json();
data.forEach(b => {
console.log(`${b.billNumber}: ${b.title} [${b.status}]`);
});Python (requests)
import requests
res = requests.get(
"https://federalstatelaw.com/api/v1/bills",
params={"jurisdiction": "federal", "status": "in_committee", "limit": 5}
)
data = res.json()
for b in data["data"]:
print(f"{b['billNumber']}: {b['title']} [{b['status']}]")Example Response
JSON
{
"data": [
{
"id": "hr-1234-119",
"jurisdiction": "United States Federal",
"jurisdictionId": "federal",
"billNumber": "H.R. 1234",
"title": "American Innovation and Jobs Act",
"chamber": "house",
"status": "in_committee",
"session": "119th Congress",
"topics": ["technology", "labor"],
"summary": "A bill to expand research and development tax credits..."
}
],
"meta": { "total": 87, "limit": 5, "offset": 0, "hasMore": true }
}Citing this endpoint
If you publish results from this endpoint, see our Citation Guide for correct attribution of public-domain U.S. legal materials.
Related
This is legal information, not legal advice. Laws vary by jurisdiction and change frequently. Always verify current law with official sources and consult a licensed attorney in your jurisdiction for advice on your specific situation.