Bills
List bills
GET
/v1/billsAll plansKeep a local copy of Congress in step: page through by updatedSince every hour and fetch only what changed. Or narrow to a Congress, chamber, sponsor or policy area to build a tracker.
Query parameters
| Name | Description |
|---|---|
| congressinteger | e.g. 119 |
| typestring | hr, s, hjres, sjres, hres, sres, hconres or sconreshr · s · hjres · sjres · hres · sres · hconres · sconres |
| chamberstring | Chamber of originHouse · Senate |
| policyAreastring | A policy area slug |
| sponsorstring | The sponsor's bioguide id |
| updatedSincedate-time | Only bills Congress.gov updated at or after this instant |
| orderstring | updated (default) or numberupdated · number |
| cursorstring | nextCursor from the previous page |
| limitinteger | Page size, 1 to 100 (default 25) |
Response
| Field | Description |
|---|---|
| dataBillSummary[] | |
| data[].billIdstring | Congress, type and number: 119-hr-1234. |
| data[].congressinteger | |
| data[].typestring | HR, S, HJRES, SJRES, HRES, SRES, HCONRES or SCONRES. |
| data[].numberinteger | |
| data[].titlestring | |
| data[].originChamberstring | null | |
| data[].introducedDatestring | null | |
| data[].latestActionLatestAction | null | |
| data[].policyAreastring | null | |
| data[].sponsorMemberRef | null | |
| data[].publicLawsstring[] | Public law numbers, e.g. 119-21. Empty unless enacted. |
| data[].updateDatestring | null | Congress.gov's last update to the bill record. |
| data[].webUrlstring | |
| nextCursorstring | null | Pass as `cursor` for the next page; null on the last page. |