Congress.gov
App · Misc References · 71 actions
Track legislation through the Library of Congress's official Congress.gov API: look up bills, amendments, laws and their full history, read CRS summaries and reports, find members and what they sponsor, follow committees, hearings, House roll call votes, nominations and treaties, and search the Congressional Record.
Actions
| Action | What it does |
|---|---|
| Get amendment | Look up one amendment by Congress, type and number. |
| Get amendment actions | Actions taken on one amendment, newest first, including the roll call vote when it was decided by one. |
| Get amendment cosponsors | The members who cosponsored one amendment, with the date each signed on. |
| Get amendment text versions | Published versions of one amendment's text, with links to each format. |
| Get amendments to an amendment | Second-degree amendments: the amendments offered to one amendment rather than to the bill itself. |
| Get bill | Look up one bill or resolution by its citation: Congress, type and number. |
| Get bill actions | The legislative history of one bill: every action taken on it, newest first, with the date, the text, and which chamber or the Library of Congress recorded it. |
| Get bill amendments | Amendments offered to one bill, each with its number, what it does and the latest action on it. |
| Get bill committees | The committees and subcommittees that handled one bill, with what each did to it and when: referred, reported, discharged. |
| Get bill cosponsors | The members who cosponsored one bill, with each member's party, state, the date they signed on, and whether they were an original cosponsor. |
| Get bill subjects | What one bill is about: the legislative subject terms the Congressional Research Service assigned to it, and the single policy area it falls under. |
| Get bill summaries | Plain-English summaries of one bill, written by the Congressional Research Service: one for each stage the bill reached, so the latest is what the bill says now. |
| Get bill text versions | Every published version of one bill's text (introduced, reported, engrossed, enrolled), each with links to the formatted text, PDF and XML on congress.gov. |
| Get bill titles | Every title one bill carries (the short title, the official title, the display title, and the titles of individual portions), with the text version each belongs to. |
| Get committee | One committee: its subcommittees, its naming history, whether it still exists, and how many bills, reports and communications have been referred to it. |
| Get committee bills | The bills referred to one committee, with the relationship ('Referred to', 'Reported by') and the date it happened. |
| Get committee House communications | The House communications referred to one House committee: the executive-branch letters and reports it receives. |
| Get committee meeting | One committee meeting: its title, when and where it sits, whether it is still scheduled, the committees holding it, the witnesses and their statements, the bills and nominations on the agenda, and any video. |
| Get committee nominations | The presidential nominations referred to one Senate committee. |
| Get committee print | One committee print by its jacket number, with its citation, the committees behind it and the bills it relates to. |
| Get committee print text | The published text of one committee print, with a link for each format it exists in. |
| Get committee report | One committee report by its citation: 'H. Rept. |
| Get committee report text | The published text of one committee report, with a link for each format it exists in and a flag on any errata version. |
| Get committee reports | The reports one committee has published, newest first. |
| Get committee Senate communications | The Senate communications referred to one Senate committee. |
| Get congress | One Congress and its sessions. |
| Get Congressional Record articles | The articles in one issue of the daily Congressional Record, grouped by the section they appear in, each with its title, page range and a link to its text. |
| Get cosponsored legislation | The bills and resolutions one member cosponsored, newest first. |
| Get CRS report | One CRS report by its product number ('R47175', 'IF12345') with its summary, current authors, topics, related legislation, and links to the PDF and HTML. |
| Get daily Congressional Record issue | One issue of the daily Congressional Record: the PDF of the whole issue, plus each section (Daily Digest, House, Senate, Extensions of Remarks) with its page range and text link. |
| Get hearing | One hearing transcript by its jacket number: its title, citation, the dates it was held, the committees that held it, and links to the transcript in each published format. |
| Get House communication | One House communication: the agency and official who sent it, an abstract of what it reports, the legal authority behind it, whether it concerns a rulemaking, the committees it went to, and the reporting requirements it satisfies. |
| Get House reporting requirement | One House reporting requirement: which agency it binds, what it must report, how often, the legal authority for it, and how many communications have been filed against it. |
| Get House vote | One House roll call vote: the measure or amendment at stake, the kind of vote, the result, and the yea/nay/present/not voting totals broken down by party. |
| Get House vote members | How each representative voted on one roll call: the member-by-member record behind the totals, with each member's party and state. |
| Get law | Look up one law by the number the National Archives assigned it: 'Public Law 117-108' is Congress 117, type Public, number 108. |
| Get member | One member's full profile: every term they have served and in which chamber, their party history, any leadership roles, their official portrait, and how much legislation they have sponsored and cosponsored. |
| Get nomination | One nomination by its PN number: who was nominated and to what post, whether it is civilian or military, when the Senate received it, and the latest action on it. |
| Get nomination actions | Senate actions on one nomination: received and referred through to confirmation, rejection or return. |
| Get nomination committees | The Senate committees one nomination was referred to, with what each did and when. |
| Get nomination hearings | Printed hearings held on one nomination, with the citation, date and jacket number of each. |
| Get nomination nominees | The people named in one part of a nomination, with the post and organisation. |
| Get related bills | Bills related to one bill (companion measures, procedurally related ones, and those with identical text), along with who identified the relationship and what kind it is. |
| Get requirement communications | The communications filed against one House reporting requirement: what agencies actually sent in to satisfy it. |
| Get Senate communication | One Senate communication: an abstract of what it reports, the date it was printed in the Congressional Record, and the committees it was referred to. |
| Get sponsored legislation | The bills and resolutions one member introduced, newest first, each with its policy area and latest action. |
| Get treaty | One treaty: its titles, the countries party to it, its index terms, when it was transmitted and when it entered into force, and the text of the resolution of ratification. |
| Get treaty actions | Senate actions on one treaty, including the vote on the resolution of advice and consent to ratification. |
| Get treaty committees | The Senate committees one treaty was referred to, with their subcommittees and what each did to it. |
| List amendments | Browse amendments, most recently acted on first. |
| List bill summaries | Bill summaries across many bills at once, newest first: the Congressional Research Service's plain-English account of what legislation does. |
| List bills | Browse bills and resolutions, most recently acted on first. |
| List bound Congressional Record | The bound Congressional Record: the permanent, page-numbered edition published after the daily one. |
| List committee meetings | Committee meetings and hearings on the schedule, newest first. |
| List committee prints | Committee prints, newest first: the background studies and draft texts committees publish outside the report series. |
| List committee reports | Committee reports, newest first: the written accounts committees file when they report a bill out. |
| List committees | Congressional committees and their subcommittees. |
| List congresses | Every Congress from the 1st to the one sitting now, with the years it sat and the start and end dates of each of its sessions. |
| List Congressional Record issues | Issues of the Congressional Record with the PDF of each section: Daily Digest, House, Senate, Extensions of Remarks and the entire issue. |
| List CRS reports | Congressional Research Service reports, newest first: the non-partisan analysis CRS writes for Congress on the issues before it. |
| List daily Congressional Record | Issues of the daily Congressional Record, newest first. |
| List hearings | Published hearing transcripts. |
| List House communications | Communications received by the House: the executive communications, memorials, presidential messages and petitions it logs and refers to committee. |
| List House reporting requirements | House reporting requirements: the standing obligations on federal agencies to report to the House, each with the number 'Get House reporting requirement' takes. |
| List House votes | House roll call votes, newest first, each with what was voted on, the result and the roll call number. |
| List laws | The bills that became law in one Congress. |
| List members | Members of Congress, most recently updated first. |
| List members by state | Who represents a state (both senators and every representative) or, with a district number, the one member for that district. |
| List nominations | Presidential nominations sent to the Senate, newest first, each with its PN citation, who was nominated and where it stands. |
| List Senate communications | Communications received by the Senate: executive communications, presidential messages, and petitions and memorials. |
| List treaties | Treaties sent to the Senate for advice and consent, newest first, each with its topic and the date it was transmitted. |
Get amendment
Look up one amendment by Congress, type and number. Returns its purpose, who offered it, the bill or amendment it amends, when it was submitted, and where it stands.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Amendment type
amendment_typetextRequired - The chamber the amendment was offered in, and its series.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Amendment number
amendment_numbernumberRequired - The number the amendment was assigned: 2137 for S.Amdt. 2137.At least 1.
Outputs
amendmentobject- The amendment
amendment_numbernumberamendment_typetextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
Example output
{
"amendment": {
"congress": 117,
"description": "Amendment changes the effective date of the bill.",
"latestAction": {
"actionDate": "2021-08-08",
"text": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28."
},
"number": "2137",
"purpose": "In the nature of a substitute.",
"type": "SAMDT",
"updateDate": "2021-08-08T12:00:00Z",
"url": "https://api.congress.gov/v3/amendment/117/samdt/2137?format=json"
},
"amendment_number": 2137,
"amendment_type": "samdt",
"congress": 117,
"found": true
}Get amendment actions
Actions taken on one amendment, newest first, including the roll call vote when it was decided by one.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Amendment type
amendment_typetextRequired - The chamber the amendment was offered in, and its series.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Amendment number
amendment_numbernumberRequired - The number the amendment was assigned: 2137 for S.Amdt. 2137.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
actionslist- Actions taken on the amendment
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"actions": [
{
"actionDate": "2021-08-08",
"sourceSystem": {
"code": 0,
"name": "Senate"
},
"text": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28. Record Vote Number: 312.",
"type": "Floor"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get amendment cosponsors
The members who cosponsored one amendment, with the date each signed on.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Amendment type
amendment_typetextRequired - The chamber the amendment was offered in, and its series.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Amendment number
amendment_numbernumberRequired - The number the amendment was assigned: 2137 for S.Amdt. 2137.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
cosponsorslist- Members cosponsoring the amendment
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"cosponsors": [
{
"bioguideId": "F000450",
"district": 5,
"firstName": "Virginia",
"fullName": "Rep. Foxx, Virginia [R-NC-5]",
"isOriginalCosponsor": true,
"lastName": "Foxx",
"party": "R",
"sponsorshipDate": "2021-05-11",
"state": "NC",
"url": "https://api.congress.gov/v3/member/F000450?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get amendment text versions
Published versions of one amendment's text, with links to each format. Congress.gov holds amendment text from the 117th Congress onwards.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Amendment type
amendment_typetextRequired - The chamber the amendment was offered in, and its series.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Amendment number
amendment_numbernumberRequired - The number the amendment was assigned: 2137 for S.Amdt. 2137.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
text_versionslist- Published versions of the amendment's text
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"text_versions": [
{
"date": "2021-08-08T04:00:00Z",
"formats": [
{
"type": "PDF",
"url": "https://www.congress.gov/117/crec/2021/08/08/CREC-2021-08-08-pt1-PgS5843.pdf"
}
],
"type": "Submitted"
}
],
"total_count": 42
}Get amendments to an amendment
Second-degree amendments: the amendments offered to one amendment rather than to the bill itself.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Amendment type
amendment_typetextRequired - The chamber the amendment was offered in, and its series.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Amendment number
amendment_numbernumberRequired - The number the amendment was assigned: 2137 for S.Amdt. 2137.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
amendmentslist- Amendments offered to this amendment
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"amendments": [
{
"congress": 117,
"description": "Amendment changes the effective date of the bill.",
"latestAction": {
"actionDate": "2021-08-08",
"text": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28."
},
"number": "2137",
"purpose": "In the nature of a substitute.",
"type": "SAMDT",
"updateDate": "2021-08-08T12:00:00Z",
"url": "https://api.congress.gov/v3/amendment/117/samdt/2137?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get bill
Look up one bill or resolution by its citation: Congress, type and number. Returns the sponsor, the date it was introduced, its policy area, the latest action taken on it, and how many actions, cosponsors, summaries, text versions and titles it has.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
Outputs
billobject- The bill or resolution
bill_numbernumberbill_typetextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
Example output
{
"bill": {
"congress": 117,
"introducedDate": "2021-05-11",
"latestAction": {
"actionDate": "2022-04-06",
"text": "Became Public Law No: 117-108."
},
"number": "3076",
"originChamber": "House",
"originChamberCode": "H",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"updateDate": "2022-09-29",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
},
"bill_number": 3076,
"bill_type": "hr",
"congress": 117,
"found": true
}Get bill actions
The legislative history of one bill: every action taken on it, newest first, with the date, the text, and which chamber or the Library of Congress recorded it.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
actionslist- Actions taken on the bill
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"actions": [
{
"actionCode": "36000",
"actionDate": "2022-04-06",
"sourceSystem": {
"code": 9,
"name": "Library of Congress"
},
"text": "Became Public Law No: 117-108.",
"type": "BecameLaw"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get bill amendments
Amendments offered to one bill, each with its number, what it does and the latest action on it.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
amendmentslist- Amendments offered to the bill
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"amendments": [
{
"congress": 117,
"description": "Amendment changes the effective date of the bill.",
"latestAction": {
"actionDate": "2021-08-08",
"text": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28."
},
"number": "2137",
"purpose": "In the nature of a substitute.",
"type": "SAMDT",
"updateDate": "2021-08-08T12:00:00Z",
"url": "https://api.congress.gov/v3/amendment/117/samdt/2137?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get bill committees
The committees and subcommittees that handled one bill, with what each did to it and when: referred, reported, discharged.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
committeeslist- Committees with activity on the bill
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"committees": [
{
"chamber": "House",
"committeeTypeCode": "Standing",
"name": "Transportation and Infrastructure Committee",
"subcommittees": [
{
"name": "Investigations and Oversight Subcommittee",
"systemCode": "hspw01",
"url": "https://api.congress.gov/v3/committee/house/hspw01?format=json"
}
],
"systemCode": "hspw00",
"url": "https://api.congress.gov/v3/committee/house/hspw00?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get bill cosponsors
The members who cosponsored one bill, with each member's party, state, the date they signed on, and whether they were an original cosponsor.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Sort by update date
sorttext - Order the results by when Congress.gov last updated them.One of:
updateDate+desc(Most recently updated first),updateDate+asc(Least recently updated first). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
cosponsorslist- Members cosponsoring the bill
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"cosponsors": [
{
"bioguideId": "F000450",
"district": 5,
"firstName": "Virginia",
"fullName": "Rep. Foxx, Virginia [R-NC-5]",
"isOriginalCosponsor": true,
"lastName": "Foxx",
"party": "R",
"sponsorshipDate": "2021-05-11",
"state": "NC",
"url": "https://api.congress.gov/v3/member/F000450?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get bill subjects
What one bill is about: the legislative subject terms the Congressional Research Service assigned to it, and the single policy area it falls under.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
legislative_subjectslist- Legislative subject terms assigned to the bill
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
policy_areaobject- The single policy area the bill falls under
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"legislative_subjects": [
{
"name": "Congressional oversight",
"updateDate": "2022-02-18"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"policy_area": {
"name": "Government Operations and Politics"
},
"total_count": 42
}Get bill summaries
Plain-English summaries of one bill, written by the Congressional Research Service: one for each stage the bill reached, so the latest is what the bill says now.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
summarieslist- CRS summaries of the bill
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"summaries": [
{
"actionDate": "2022-03-08",
"actionDesc": "Passed Senate",
"text": "<p>This bill addresses the finances and operations of the U.S. Postal Service.</p>",
"updateDate": "2022-03-11T04:36:07Z",
"versionCode": "55"
}
],
"total_count": 42
}Get bill text versions
Every published version of one bill's text (introduced, reported, engrossed, enrolled), each with links to the formatted text, PDF and XML on congress.gov.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
text_versionslist- Published versions of the bill's text
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"text_versions": [
{
"date": "2022-04-06T04:00:00Z",
"formats": [
{
"type": "Formatted Text",
"url": "https://www.congress.gov/117/bills/hr3076/BILLS-117hr3076enr.htm"
}
],
"type": "Enrolled Bill"
}
],
"total_count": 42
}Get bill titles
Every title one bill carries (the short title, the official title, the display title, and the titles of individual portions), with the text version each belongs to.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
titleslist- Titles the bill carries
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"titles": [
{
"title": "Postal Service Reform Act of 2022",
"titleType": "Display Title",
"titleTypeCode": 45,
"updateDate": "2022-04-06T14:00:00Z"
}
],
"total_count": 42
}Get committee
One committee: its subcommittees, its naming history, whether it still exists, and how many bills, reports and communications have been referred to it.
Inputs
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Committee
committee_codetextRequired - The committee to look at. Pick a chamber first; the list is that chamber's committees and subcommittees.
- Congress
congressnumber - Ask about the committee as it stood in one Congress. Leave empty for how it stands now.From 1 to 999.
Outputs
chambertextcommitteeobject- The committee
committee_codetextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
Example output
{
"chamber": "house",
"committee": {
"bills": {
"count": 25384
},
"history": [
{
"libraryOfCongressName": "Transportation and Infrastructure",
"officialName": "Committee on Transportation and Infrastructure",
"startDate": "1995-01-04T05:00:00Z"
}
],
"isCurrent": true,
"reports": {
"count": 1163
},
"subcommittees": [
{
"name": "Investigations and Oversight Subcommittee",
"systemCode": "hspw01",
"url": "https://api.congress.gov/v3/committee/house/hspw01?format=json"
}
],
"systemCode": "hspw00",
"type": "Standing"
},
"committee_code": "hspw00",
"congress": null,
"found": true
}Get committee bills
The bills referred to one committee, with the relationship ('Referred to', 'Reported by') and the date it happened.
Inputs
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Committee
committee_codetextRequired - The committee to look at. Pick a chamber first; the list is that chamber's committees and subcommittees.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
billslist- Bills referred to the committee
chambertextcommittee_codetextcountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"bills": [
{
"actionDate": "2021-05-11T04:00:00Z",
"congress": 117,
"number": "3076",
"relationshipType": "Referred to",
"type": "HR",
"updateDate": "2022-04-06T14:00:00Z",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
}
],
"chamber": "house",
"committee_code": "hsgo00",
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get committee House communications
The House communications referred to one House committee: the executive-branch letters and reports it receives.
Inputs
- House committee
committee_codetextRequired - The House committee to look at.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcommittee_codetextcommunicationslist- House communications referred to the committee
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"committee_code": "hspw00",
"communications": [
{
"chamber": "House",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 118,
"number": "3324",
"referralDate": "2024-03-07",
"updateDate": "2024-09-03",
"url": "https://api.congress.gov/v3/house-communication/118/ec/3324?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get committee meeting
One committee meeting: its title, when and where it sits, whether it is still scheduled, the committees holding it, the witnesses and their statements, the bills and nominations on the agenda, and any video.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Event id
event_idtextRequired - The meeting's event identifier: '115538'. 'List committee meetings' returns it for every meeting.
Outputs
chambertextcongressnumberevent_idtextfoundtrue/false- Whether the record exists on Congress.gov
meetingobject- The committee meeting
Example output
{
"chamber": "house",
"congress": 118,
"event_id": "115538",
"found": true,
"meeting": {
"chamber": "House",
"congress": 118,
"date": "2023-03-24T14:00:00Z",
"eventId": "115538",
"location": {
"building": "Longworth House Office Building",
"room": "1324"
},
"meetingStatus": "Scheduled",
"title": "Legislative hearing on H.R. 1246 and H.R. 1532",
"type": "Hearing",
"updateDate": "2023-03-27T04:44:57Z",
"url": "https://api.congress.gov/v3/committee-meeting/118/house/115538?format=json",
"witnesses": [
{
"name": "The Honorable John Williams",
"organization": "United Auburn Rancheria",
"position": "Vice Chairman"
}
]
}
}Get committee nominations
The presidential nominations referred to one Senate committee. Only Senate committees receive nominations, so the chamber is fixed.
Inputs
- Senate committee
committee_codetextRequired - The Senate committee to look at.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcommittee_codetextcountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nominationslist- Nominations referred to the committee
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "senate",
"committee_code": "ssas00",
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"nominations": [
{
"citation": "PN2804",
"congress": 117,
"description": "Mary Anne Carter, of Tennessee, to be Chairperson of the National Endowment for the Arts for a term of four years.",
"latestAction": {
"actionDate": "2022-12-07",
"text": "Received in the Senate and referred to the Committee."
},
"nominationType": {
"isCivilian": true,
"isMilitary": false
},
"number": 2804,
"partNumber": "00",
"receivedDate": "2022-12-07",
"updateDate": "2022-12-08T05:25:17Z",
"url": "https://api.congress.gov/v3/nomination/117/2804?format=json"
}
],
"offset": 0,
"total_count": 42
}Get committee print
One committee print by its jacket number, with its citation, the committees behind it and the bills it relates to.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Jacket number
jacket_numbernumberRequired - The GPO jacket number that identifies the document: 48144, for example. The list actions return it for every record.At least 1.
Outputs
chambertextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
jacket_numbernumberprintobject- The committee print
Example output
{
"chamber": "house",
"congress": 117,
"found": true,
"jacket_number": 48144,
"print": {
"chamber": "House",
"citation": "117-62",
"committees": [
{
"name": "Rules Committee",
"systemCode": "hsru00",
"url": "https://api.congress.gov/v3/committee/house/hsru00?format=json"
}
],
"congress": 117,
"jacketNumber": 48144,
"number": "62",
"text": {
"count": 4
},
"title": "RULES COMMITTEE PRINT 117-62",
"updateDate": "2022-08-01T21:19:33Z",
"url": "https://api.congress.gov/v3/committee-print/117/house/48144?format=json"
}
}Get committee print text
The published text of one committee print, with a link for each format it exists in.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Jacket number
jacket_numbernumberRequired - The GPO jacket number that identifies the document: 48144, for example. The list actions return it for every record.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcongressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
jacket_numbernumberlimitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
text_versionslist- Published formats of the print's text
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"congress": 117,
"count": 1,
"has_more": true,
"jacket_number": 48144,
"limit": 20,
"next_offset": 20,
"offset": 0,
"text_versions": [
{
"type": "Formatted Text",
"url": "https://www.congress.gov/117/cprt/HPRT48144/CPRT-117HPRT48144.htm"
}
],
"total_count": 42
}Get committee report
One committee report by its citation: 'H. Rept. 117-89' is Congress 117, type H.Rept., number 89. A report filed in parts returns each part.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Report type
report_typetextRequired - Which series the report belongs to.One of:
hrpt(H.Rept.: House Report),srpt(S.Rept.: Senate Report),erpt(Ex.Rept.: Senate Executive Report). - Report number
report_numbernumberRequired - The part after the hyphen: 89 for H. Rept. 117-89.At least 1.
Outputs
congressnumberfoundtrue/false- Whether the record exists on Congress.gov
partslist- Every part filed under this report number
reportobject- The committee report
report_numbernumberreport_typetext
Example output
{
"congress": 117,
"found": true,
"parts": [
{
"chamber": "House",
"citation": "H. Rept. 117-89",
"congress": 117,
"number": 89,
"part": 1,
"type": "HRPT",
"updateDate": "2022-02-18T16:38:41Z",
"url": "https://api.congress.gov/v3/committee-report/117/HRPT/89?format=json"
}
],
"report": {
"chamber": "House",
"citation": "H. Rept. 117-89",
"congress": 117,
"number": 89,
"part": 1,
"type": "HRPT",
"updateDate": "2022-02-18T16:38:41Z",
"url": "https://api.congress.gov/v3/committee-report/117/HRPT/89?format=json"
},
"report_number": 89,
"report_type": "hrpt"
}Get committee report text
The published text of one committee report, with a link for each format it exists in and a flag on any errata version.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Report type
report_typetextRequired - Which series the report belongs to.One of:
hrpt(H.Rept.: House Report),srpt(S.Rept.: Senate Report),erpt(Ex.Rept.: Senate Executive Report). - Report number
report_numbernumberRequired - The part after the hyphen in the citation.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
report_numbernumberreport_typetexttext_versionslist- Published formats of the report's text
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"report_number": 89,
"report_type": "hrpt",
"text_versions": [
{
"isErrata": "N",
"type": "Formatted Text",
"url": "https://www.congress.gov/117/crpt/hrpt89/generated/CRPT-117hrpt89.htm"
}
],
"total_count": 42
}Get committee reports
The reports one committee has published, newest first.
Inputs
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Committee
committee_codetextRequired - The committee to look at. Pick a chamber first; the list is that chamber's committees and subcommittees.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcommittee_codetextcountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
reportslist- Reports the committee published
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"committee_code": "hspw00",
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"reports": [
{
"chamber": "House",
"citation": "H. Rept. 117-89",
"congress": 117,
"number": 89,
"part": 1,
"type": "HRPT",
"updateDate": "2022-02-18T16:38:41Z",
"url": "https://api.congress.gov/v3/committee-report/117/HRPT/89?format=json"
}
],
"total_count": 42
}Get committee Senate communications
The Senate communications referred to one Senate committee.
Inputs
- Senate committee
committee_codetextRequired - The Senate committee to look at.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcommittee_codetextcommunicationslist- Senate communications referred to the committee
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "senate",
"committee_code": "ssju00",
"communications": [
{
"chamber": "Senate",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 118,
"number": "3324",
"referralDate": "2024-03-07",
"updateDate": "2024-09-03",
"url": "https://api.congress.gov/v3/senate-communication/117/ec/1615?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get congress
One Congress and its sessions. Leave the number empty for the Congress sitting right now (which is how a workflow finds the current Congress number to feed the other actions).
Inputs
- Congress
congressnumber - Which Congress to look up. Leave empty for the one sitting now.From 1 to 999.
Outputs
congressobject- The Congress and its sessions
foundtrue/false- Whether the record exists on Congress.gov
is_current_requesttrue/false- Whether the currently sitting Congress was asked for
numbernumber- The Congress's number, e.g. 119
Example output
{
"congress": {
"endYear": "2026",
"name": "119th Congress",
"number": 119,
"sessions": [
{
"chamber": "House of Representatives",
"endDate": "2026-01-03",
"number": 1,
"startDate": "2025-01-03"
}
],
"startYear": "2025",
"url": "https://api.congress.gov/v3/congress/119?format=json"
},
"found": true,
"is_current_request": true,
"number": 119
}Get Congressional Record articles
The articles in one issue of the daily Congressional Record, grouped by the section they appear in, each with its title, page range and a link to its text.
Inputs
- Volume
volume_numbernumberRequired - The Congressional Record volume: one per year, 171 for 2025.At least 1.
- Issue
issue_numbernumberRequired - The issue number within the volume: one per day of session.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
articleslist- Sections, each holding the articles printed in it
countnumber- Records on this page
has_moretrue/false- Whether another page follows
issue_numbernumberlimitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
volume_numbernumber
Example output
{
"articles": [
{
"name": "Daily Digest",
"sectionArticles": [
{
"endPage": "D760",
"startPage": "D759",
"text": [
{
"type": "Formatted Text",
"url": "https://www.congress.gov/116/crec/2020/09/04/modified/CREC-2020-09-04-pt1-PgD759.htm"
}
],
"title": "Daily Digest/Next Meeting of the SENATE"
}
]
}
],
"count": 1,
"has_more": true,
"issue_number": 153,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"volume_number": 166
}Get cosponsored legislation
The bills and resolutions one member cosponsored, newest first. Cosponsorships the member later withdrew are excluded.
Inputs
- Member
bioguide_idtextRequired - The member to look at. The list holds every member serving now; for a former member, use the bioguide id from 'List members'.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
bioguide_idtextcountnumber- Records on this page
has_moretrue/false- Whether another page follows
legislationlist- Bills and resolutions the member cosponsored
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"bioguide_id": "L000174",
"count": 1,
"has_more": true,
"legislation": [
{
"congress": 117,
"introducedDate": "2021-05-11",
"latestAction": {
"actionDate": "2022-04-06",
"text": "Became Public Law No: 117-108."
},
"number": "3076",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get CRS report
One CRS report by its product number ('R47175', 'IF12345') with its summary, current authors, topics, related legislation, and links to the PDF and HTML.
Inputs
- Report number
report_numbertextRequired - The CRS product number. 'List CRS reports' returns it for every report.
Outputs
foundtrue/false- Whether the record exists on Congress.gov
reportobject- The CRS report
report_numbertext
Example output
{
"found": true,
"report": {
"authors": [
{
"author": "Megan S. Lynch"
}
],
"contentType": "Reports",
"formats": [
{
"format": "PDF",
"url": "https://www.congress.gov/crs_external_products/R/PDF/R47175/R47175.1.pdf"
}
],
"id": "R47175",
"publishDate": "2022-07-11T04:00:00Z",
"status": "Active",
"summary": "The Congressional Budget Act of 1974 directs Congress to adopt a budget resolution each spring.",
"title": "Setting Budgetary Levels: The House's FY2023 Deeming Resolution",
"topics": [
{
"topic": "Budget & Appropriations Procedure"
}
],
"updateDate": "2025-06-20T23:46:23Z",
"url": "https://api.congress.gov/v3/crsreport/R47175",
"version": 1
},
"report_number": "R47175"
}Get daily Congressional Record issue
One issue of the daily Congressional Record: the PDF of the whole issue, plus each section (Daily Digest, House, Senate, Extensions of Remarks) with its page range and text link.
Inputs
- Volume
volume_numbernumberRequired - The Congressional Record volume: one per year, 171 for 2025.At least 1.
- Issue
issue_numbernumberRequired - The issue number within the volume: one per day of session.At least 1.
Outputs
foundtrue/false- Whether the record exists on Congress.gov
issueobject- The issue and its sections
issue_numbernumbervolume_numbernumber
Example output
{
"found": true,
"issue": {
"congress": 119,
"fullIssue": {
"articles": {
"count": 315
},
"entireIssue": [
{
"part": "1",
"type": "PDF",
"url": "https://www.congress.gov/119/crec/2025/01/03/171/1/CREC-2025-01-03-v171.pdf"
}
],
"sections": [
{
"endPage": "D12",
"name": "Daily Digest",
"startPage": "D1"
}
]
},
"issueDate": "2025-01-03T05:00:00Z",
"issueNumber": "1",
"sessionNumber": 1,
"volumeNumber": 171
},
"issue_number": 1,
"volume_number": 171
}Get hearing
One hearing transcript by its jacket number: its title, citation, the dates it was held, the committees that held it, and links to the transcript in each published format.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Chamber
chambertextRequired - Which chamber the record belongs to.One of:
house,senate,joint. - Jacket number
jacket_numbernumberRequired - The GPO jacket number that identifies the document: 48144, for example. The list actions return it for every record.At least 1.
Outputs
chambertextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
hearingobject- The hearing transcript
jacket_numbernumber
Example output
{
"chamber": "house",
"congress": 118,
"found": true,
"hearing": {
"chamber": "House",
"citation": "H.Hrg.118",
"congress": 118,
"dates": [
"2023-06-21"
],
"formats": [
{
"type": "Formatted Text",
"url": "https://www.congress.gov/118/chrg/CHRG-118hhrg50896/CHRG-118hhrg50896.htm"
}
],
"jacketNumber": 50896,
"title": "FEDERAL PANDEMIC SPENDING: A PRESCRIPTION FOR WASTE, FRAUD AND ABUSE",
"updateDate": "2025-11-04T03:21:12Z",
"url": "https://api.congress.gov/v3/hearing/118/house/50896?format=json"
},
"jacket_number": 50896
}Get House communication
One House communication: the agency and official who sent it, an abstract of what it reports, the legal authority behind it, whether it concerns a rulemaking, the committees it went to, and the reporting requirements it satisfies.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Communication type
communication_typetextRequired - Which kind of communication it is.One of:
ec(Executive communication),ml(Memorial),pm(Presidential message),pt(Petition). - Communication number
communication_numbernumberRequired - The number it was assigned: 3324.At least 1.
Outputs
communicationobject- The House communication
communication_numbernumbercommunication_typetextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
Example output
{
"communication": {
"abstract": "A letter from the Director, Regulatory Management Division, Environmental Protection Agency.",
"chamber": "House",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 118,
"congressionalRecordDate": "2024-03-07",
"isRulemaking": "True",
"legalAuthority": "5 U.S.C. 801(a)(1)(A)",
"number": 3324,
"sessionNumber": 2,
"submittingAgency": "Environmental Protection Agency",
"submittingOfficial": "Director, Regulatory Management Division",
"updateDate": "2024-09-03"
},
"communication_number": 3324,
"communication_type": "ec",
"congress": 118,
"found": true
}Get House reporting requirement
One House reporting requirement: which agency it binds, what it must report, how often, the legal authority for it, and how many communications have been filed against it.
Inputs
- Requirement number
requirement_numbernumberRequired - The number the reporting requirement was assigned: 8070.At least 1.
Outputs
foundtrue/false- Whether the record exists on Congress.gov
requirementobject- The reporting requirement
requirement_numbernumber
Example output
{
"found": true,
"requirement": {
"activeRecord": true,
"frequency": "[No deadline specified].",
"legalAuthority": "5 U.S.C. 801(a)(1)(A)",
"matchingCommunications": {
"count": 90774
},
"nature": "Congressional review of agency rulemaking.",
"number": 8070,
"parentAgency": "Multiple Executive Agencies and Departments",
"submittingAgency": "Multiple Executive Agencies and Departments",
"updateDate": "2021-08-13"
},
"requirement_number": 8070
}Get House vote
One House roll call vote: the measure or amendment at stake, the kind of vote, the result, and the yea/nay/present/not voting totals broken down by party.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Session
sessiontextRequired - Which of the Congress's two yearly sessions the vote was in.One of:
1(First session (odd-numbered year)),2(Second session (even-numbered year)). - Roll call number
vote_numbernumberRequired - The roll call number within the session: 17 for the 17th recorded vote of that year.At least 1.
Outputs
congressnumberfoundtrue/false- Whether the record exists on Congress.gov
sessionnumbervoteobject- The roll call vote and its party totals
vote_numbernumber
Example output
{
"congress": 119,
"found": true,
"session": 1,
"vote": {
"congress": 119,
"identifier": 1191202517,
"legislationNumber": "30",
"legislationType": "HR",
"legislationUrl": "https://congress.gov/bill/119/house-bill/30",
"result": "Passed",
"rollCallNumber": 17,
"sessionNumber": 1,
"sourceDataURL": "https://clerk.house.gov/evs/2025/roll017.xml",
"startDate": "2025-01-16T11:00:00-05:00",
"url": "https://api.congress.gov/v3/house-vote/119/1/17",
"votePartyTotal": [
{
"nayTotal": 0,
"notVotingTotal": 6,
"party": {
"name": "Republican",
"type": "R"
},
"presentTotal": 0,
"yeaTotal": 213
}
],
"voteType": "Yea-and-Nay"
},
"vote_number": 17
}Get House vote members
How each representative voted on one roll call: the member-by-member record behind the totals, with each member's party and state.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Session
sessiontextRequired - Which of the Congress's two yearly sessions the vote was in.One of:
1(First session (odd-numbered year)),2(Second session (even-numbered year)). - Roll call number
vote_numbernumberRequired - The roll call number within the session.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
member_voteslist- How each member voted
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
sessionnumbertotal_countnumber- Records matching in all, across every page
voteobject- The vote these member records belong to
vote_numbernumber
Example output
{
"congress": 119,
"count": 1,
"has_more": true,
"limit": 20,
"member_votes": [
{
"bioguideID": "A000055",
"firstName": "Robert",
"lastName": "Aderholt",
"voteCast": "Yea",
"voteParty": "R",
"voteState": "AL"
}
],
"next_offset": 20,
"offset": 0,
"session": 1,
"total_count": 42,
"vote": {
"congress": 119,
"rollCallNumber": 17,
"sessionNumber": 1
},
"vote_number": 17
}Get law
Look up one law by the number the National Archives assigned it: 'Public Law 117-108' is Congress 117, type Public, number 108. Returns the bill it came from, in full.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Law type
law_typetextRequired - Whether it is a public or a private law.One of:
pub(Public law),priv(Private law). - Law number
law_numbernumberRequired - The part after the hyphen: 108 for Public Law 117-108.At least 1.
Outputs
congressnumberfoundtrue/false- Whether the record exists on Congress.gov
lawobject- The bill that became this law
law_numbernumberlaw_typetext
Example output
{
"congress": 117,
"found": true,
"law": {
"congress": 117,
"introducedDate": "2021-05-11",
"latestAction": {
"actionDate": "2022-04-06",
"text": "Became Public Law No: 117-108."
},
"laws": [
{
"number": "117-108",
"type": "Public Law"
}
],
"number": "3076",
"originChamber": "House",
"originChamberCode": "H",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"updateDate": "2022-09-29",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
},
"law_number": 108,
"law_type": "pub"
}Get member
One member's full profile: every term they have served and in which chamber, their party history, any leadership roles, their official portrait, and how much legislation they have sponsored and cosponsored.
Inputs
- Member
bioguide_idtextRequired - The member to look at. The list holds every member serving now; for a former member, use the bioguide id from 'List members'.
Outputs
bioguide_idtextfoundtrue/false- Whether the record exists on Congress.gov
memberobject- The member's profile
Example output
{
"bioguide_id": "L000174",
"found": true,
"member": {
"bioguideId": "L000174",
"birthYear": "1940",
"cosponsoredLegislation": {
"count": 7452
},
"directOrderName": "Patrick J. Leahy",
"invertedOrderName": "Leahy, Patrick J.",
"partyHistory": [
{
"partyAbbreviation": "D",
"partyName": "Democrat",
"startYear": 1975
}
],
"sponsoredLegislation": {
"count": 1768
},
"state": "Vermont",
"terms": [
{
"chamber": "Senate",
"congress": 117,
"endYear": 2023,
"startYear": 2021,
"stateCode": "VT"
}
]
}
}Get nomination
One nomination by its PN number: who was nominated and to what post, whether it is civilian or military, when the Senate received it, and the latest action on it.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Nomination number
nomination_numbernumberRequired - The PN number without its prefix: 2804 for PN2804.At least 1.
Outputs
congressnumberfoundtrue/false- Whether the record exists on Congress.gov
nominationobject- The nomination
nomination_numbernumber
Example output
{
"congress": 117,
"found": true,
"nomination": {
"actions": {
"count": 7
},
"citation": "PN2804",
"committees": {
"count": 1
},
"congress": 117,
"description": "Mary Anne Carter, of Tennessee, to be Chairperson of the National Endowment for the Arts for a term of four years.",
"hearings": {
"count": 1
},
"latestAction": {
"actionDate": "2022-12-07",
"text": "Received in the Senate and referred to the Committee."
},
"nominationType": {
"isCivilian": true,
"isMilitary": false
},
"nominees": [
{
"nomineeCount": 1,
"ordinal": 1,
"organization": "Federal Maritime Commission",
"positionTitle": "Federal Maritime Commissioner",
"url": "https://api.congress.gov/v3/nomination/118/16/1?format=json"
}
],
"number": 2804,
"partNumber": "00",
"receivedDate": "2022-12-07",
"updateDate": "2022-12-08T05:25:17Z",
"url": "https://api.congress.gov/v3/nomination/117/2804?format=json"
},
"nomination_number": 2804
}Get nomination actions
Senate actions on one nomination: received and referred through to confirmation, rejection or return.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Nomination number
nomination_numbernumberRequired - The PN number without its prefix: 2804 for PN2804.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
actionslist- Senate actions on the nomination
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nomination_numbernumberoffsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"actions": [
{
"actionCode": "S05120",
"actionDate": "2022-08-03",
"committees": [
{
"name": "Armed Services Committee",
"systemCode": "ssas00",
"url": "https://api.congress.gov/v3/committee/senate/ssas00?format=json"
}
],
"text": "Received in the Senate and referred to the Committee on Armed Services",
"type": "IntroReferral"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"nomination_number": 2804,
"offset": 0,
"total_count": 42
}Get nomination committees
The Senate committees one nomination was referred to, with what each did and when.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Nomination number
nomination_numbernumberRequired - The PN number without its prefix: 2804 for PN2804.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
committeeslist- Committees the nomination was referred to
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nomination_numbernumberoffsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"committees": [
{
"activities": [
{
"date": "2022-08-03T04:00:00Z",
"name": "Referred to"
}
],
"chamber": "Senate",
"name": "Judiciary Committee",
"systemCode": "ssju00",
"type": "Standing",
"url": "https://api.congress.gov/v3/committee/senate/ssju00?format=json"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"nomination_number": 2804,
"offset": 0,
"total_count": 42
}Get nomination hearings
Printed hearings held on one nomination, with the citation, date and jacket number of each.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Nomination number
nomination_numbernumberRequired - The PN number without its prefix: 2804 for PN2804.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
hearingslist- Hearings held on the nomination
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nomination_numbernumberoffsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 118,
"count": 1,
"has_more": true,
"hearings": [
{
"chamber": "Senate",
"citation": "S.Hrg.118-694",
"date": "2024-02-28",
"jacketNumber": 61203,
"number": 694
}
],
"limit": 20,
"next_offset": 20,
"nomination_number": 16,
"offset": 0,
"total_count": 42
}Get nomination nominees
The people named in one part of a nomination, with the post and organisation. A military nomination can list thousands of officers in a single filing, which is why it is split into parts.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Nomination number
nomination_numbernumberRequired - The PN number without its prefix: 2804 for PN2804.At least 1.
- Part
ordinalnumber - Which part of the nomination to read, counting from 1. Defaults to the first part.At least 1. Default:
1. - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nomination_numbernumbernomineeslist- People named in this part of the nomination
offsetnumber- Records skipped before this page
ordinalnumbertotal_countnumber- Records matching in all, across every page
Example output
{
"congress": 118,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"nomination_number": 16,
"nominees": [
{
"nomineeCount": 1,
"ordinal": 1,
"organization": "Federal Maritime Commission",
"positionTitle": "Federal Maritime Commissioner",
"url": "https://api.congress.gov/v3/nomination/118/16/1?format=json"
}
],
"offset": 0,
"ordinal": 1,
"total_count": 42
}Get related bills
Bills related to one bill (companion measures, procedurally related ones, and those with identical text), along with who identified the relationship and what kind it is.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Bill type
bill_typetextRequired - The kind of measure. 'H.R. 3076' is bill type H.R.; 'S. 1234' is S.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Bill number
bill_numbernumberRequired - The number the measure was assigned: 3076 for H.R. 3076.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
related_billslist- Bills related to this one
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"related_bills": [
{
"congress": 117,
"number": 1720,
"relationshipDetails": [
{
"identifiedBy": "CRS",
"type": "Related bill"
}
],
"title": "Postal Service Reform Act of 2021",
"type": "S"
}
],
"total_count": 42
}Get requirement communications
The communications filed against one House reporting requirement: what agencies actually sent in to satisfy it.
Inputs
- Requirement number
requirement_numbernumberRequired - The number the reporting requirement was assigned: 8070.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
communicationslist- Communications filed against the requirement
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
requirement_numbernumbertotal_countnumber- Records matching in all, across every page
Example output
{
"communications": [
{
"chamber": "House",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 112,
"number": 2,
"url": "https://api.congress.gov/v3/house-communication/112/EC/2?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"requirement_number": 8070,
"total_count": 42
}Get Senate communication
One Senate communication: an abstract of what it reports, the date it was printed in the Congressional Record, and the committees it was referred to.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Communication type
communication_typetextRequired - Which kind of communication it is.One of:
ec(Executive communication),pm(Presidential message),pom(Petition or memorial). - Communication number
communication_numbernumberRequired - The number it was assigned: 1615.At least 1.
Outputs
communicationobject- The Senate communication
communication_numbernumbercommunication_typetextcongressnumberfoundtrue/false- Whether the record exists on Congress.gov
Example output
{
"communication": {
"abstract": "A communication from the Secretary of Defense, transmitting a report.",
"chamber": "Senate",
"congress": 117,
"congressionalRecordDate": "2021-09-01",
"number": 1615,
"sessionNumber": 1,
"updateDate": "2021-09-02"
},
"communication_number": 1615,
"communication_type": "ec",
"congress": 117,
"found": true
}Get sponsored legislation
The bills and resolutions one member introduced, newest first, each with its policy area and latest action.
Inputs
- Member
bioguide_idtextRequired - The member to look at. The list holds every member serving now; for a former member, use the bioguide id from 'List members'.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
bioguide_idtextcountnumber- Records on this page
has_moretrue/false- Whether another page follows
legislationlist- Bills and resolutions the member sponsored
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"bioguide_id": "L000174",
"count": 1,
"has_more": true,
"legislation": [
{
"congress": 117,
"introducedDate": "2022-06-16",
"latestAction": {
"actionDate": "2022-06-16",
"text": "Read twice and referred to the Committee on the Judiciary."
},
"number": "4417",
"policyArea": {
"name": "Commerce"
},
"title": "Patent Trial and Appeal Board Reform Act of 2022",
"type": "S",
"url": "https://api.congress.gov/v3/bill/117/s/4417?format=json"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}Get treaty
One treaty: its titles, the countries party to it, its index terms, when it was transmitted and when it entered into force, and the text of the resolution of ratification.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Treaty number
treaty_numbernumberRequired - The treaty's number within the Congress that received it.At least 1.
- Part
treaty_suffixtext - The partition letter of a treaty split into parts: 'A', 'B'. Leave empty for a treaty that is not split.
Outputs
congressnumberfoundtrue/false- Whether the record exists on Congress.gov
treatyobject- The treaty
treaty_numbernumbertreaty_suffixtext
Example output
{
"congress": 117,
"found": true,
"treaty": {
"actions": {
"count": 3
},
"congressConsidered": 117,
"congressReceived": 117,
"countriesParties": [
{
"name": "Belgium"
}
],
"indexTerms": [
{
"name": "TAXATION"
}
],
"number": 3,
"suffix": "",
"titles": [
{
"title": "PROTOCOL MODIFYING CONVENTION WITH BELGIUM FOR THE AVOIDANCE OF DOUBLE TAXATION",
"titleType": "Treaty - Short Title"
}
],
"topic": "Taxation",
"transmittedDate": "2021-05-17T00:00:00Z",
"updateDate": "2022-02-26T16:25:25Z",
"url": "https://api.congress.gov/v3/treaty/117/3?format=json"
},
"treaty_number": 3,
"treaty_suffix": null
}Get treaty actions
Senate actions on one treaty, including the vote on the resolution of advice and consent to ratification. Give a part letter for a treaty split into parts.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Treaty number
treaty_numbernumberRequired - The treaty's number within the Congress that received it.At least 1.
- Part
treaty_suffixtext - The partition letter of a treaty split into parts: 'A', 'B'. Leave empty for a treaty that is not split.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
actionslist- Senate actions on the treaty
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
treaty_numbernumbertreaty_suffixtext
Example output
{
"actions": [
{
"actionCode": "S05291",
"actionDate": "2022-08-03",
"text": "Resolution of advice and consent to ratification agreed to in Senate by Yea-Nay Vote. 95 - 1. Record Vote Number: 282.",
"type": "Floor"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"treaty_number": 3,
"treaty_suffix": null
}Get treaty committees
The Senate committees one treaty was referred to, with their subcommittees and what each did to it.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Treaty number
treaty_numbernumberRequired - The treaty's number within the Congress that received it.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
committeeslist- Committees the treaty was referred to
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
treaty_numbernumber
Example output
{
"committees": [
{
"activities": [
{
"date": "2021-10-19T04:00:00Z",
"name": "Reported by"
}
],
"chamber": "Senate",
"name": "Foreign Relations Committee",
"systemCode": "ssfr00",
"type": "Standing",
"url": "https://api.congress.gov/v3/committee/senate/ssfr00?format=json"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"treaty_number": 3
}List amendments
Browse amendments, most recently acted on first. Narrow to one Congress, then to House, Senate or Senate unprinted amendments.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Amendment type
amendment_typetext - Narrow the list to one series of amendments. Needs a Congress as well. Leave empty for every type.One of:
hamdt(H.Amdt.: House Amendment),samdt(S.Amdt.: Senate Amendment),suamdt(S.Up.Amdt.: Senate Unprinted Amendment). - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
amendment_typetextamendmentslist- Amendments, each with its number, purpose and latest action
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"amendment_type": "samdt",
"amendments": [
{
"congress": 117,
"description": "Amendment changes the effective date of the bill.",
"latestAction": {
"actionDate": "2021-08-08",
"text": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28."
},
"number": "2137",
"purpose": "In the nature of a substitute.",
"type": "SAMDT",
"updateDate": "2021-08-08T12:00:00Z",
"url": "https://api.congress.gov/v3/amendment/117/samdt/2137?format=json"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List bill summaries
Bill summaries across many bills at once, newest first: the Congressional Research Service's plain-English account of what legislation does. Narrow to one Congress and bill type, or filter by when the summary was written to follow what is being summarised now.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Bill type
bill_typetext - Narrow the list to one kind of measure. Needs a Congress as well. Leave empty for every type.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Sort by update date
sorttext - Order the results by when Congress.gov last updated them.One of:
updateDate+desc(Most recently updated first),updateDate+asc(Least recently updated first). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
bill_typetextcongressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
summarieslist- Bill summaries, each with the bill it belongs to
total_countnumber- Records matching in all, across every page
Example output
{
"bill_type": "hr",
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"summaries": [
{
"actionDate": "2022-03-08",
"actionDesc": "Passed Senate",
"bill": {
"congress": 117,
"number": "3076",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
},
"currentChamber": "Senate",
"text": "<p>This bill addresses the finances and operations of the U.S. Postal Service.</p>",
"updateDate": "2022-03-11T04:36:07Z",
"versionCode": "55"
}
],
"total_count": 42
}List bills
Browse bills and resolutions, most recently acted on first. Narrow to one Congress, then to one type of measure, or leave both empty to walk everything Congress.gov holds. The 'Updated on or after' filter turns this into a feed of what moved since a given moment.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Bill type
bill_typetext - Narrow the list to one kind of measure. Needs a Congress as well. Leave empty for every type.One of:
hr(H.R.: House Bill),s(S.: Senate Bill),hjres(H.J.Res.: House Joint Resolution),sjres(S.J.Res.: Senate Joint Resolution),hconres(H.Con.Res.: House Concurrent Resolution),sconres(S.Con.Res.: Senate Concurrent Resolution),hres(H.Res.: House Simple Resolution),sres(S.Res.: Senate Simple Resolution). - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
bill_typetextbillslist- Bills and resolutions, each with its citation, title and latest action
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"bill_type": "hr",
"bills": [
{
"congress": 117,
"introducedDate": "2021-05-11",
"latestAction": {
"actionDate": "2022-04-06",
"text": "Became Public Law No: 117-108."
},
"number": "3076",
"originChamber": "House",
"originChamberCode": "H",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"updateDate": "2022-09-29",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List bound Congressional Record
The bound Congressional Record: the permanent, page-numbered edition published after the daily one. Give a publication date for one day, or a year and month for a wider list.
Inputs
- Published on
published_ondate - The publication date to look up. Leave empty to filter by year and month instead, or to list the most recent issues.
- Year
yearnumber - The publication year, when you want a whole year or month rather than one day. Cannot be combined with a publication date.From 1789 to 2200.
- Month
monthnumber - The publication month, 1-12. Needs a year as well.From 1 to 12.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
daynumberhas_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
monthnumbernext_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
volumeslist- Bound Congressional Record volumes
yearnumber
Example output
{
"count": 1,
"day": 1,
"has_more": true,
"limit": 20,
"month": 5,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"volumes": [
{
"congress": 101,
"date": "1990-05-01",
"sessionNumber": 2,
"updateDate": "2020-10-20",
"url": "https://api.congress.gov/v3/bound-congressional-record/1990/5/1?format=json",
"volumeNumber": 136
}
],
"year": 1990
}List committee meetings
Committee meetings and hearings on the schedule, newest first. Narrow to one Congress and chamber. Each entry carries an 'event_id' that 'Get committee meeting' takes.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Chamber
chambertext - Narrow the list to one chamber. Leave empty for all of them.One of:
house,senate,joint. - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcongressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
meetingslist- Committee meetings, each carrying an 'event_id' that 'Get committee meeting' takes
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"congress": 118,
"count": 1,
"has_more": true,
"limit": 20,
"meetings": [
{
"chamber": "House",
"congress": 118,
"event_id": "115538",
"eventid": "115538",
"updateDate": "2023-03-27T04:44:57Z",
"url": "https://api.congress.gov/v3/committee-meeting/118/house/115538?format=json"
}
],
"next_offset": 20,
"offset": 0,
"total_count": 42
}List committee prints
Committee prints, newest first: the background studies and draft texts committees publish outside the report series.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Chamber
chambertext - Narrow the list to one chamber. Leave empty for all of them.One of:
house,senate,joint. - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcongressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
printslist- Committee prints, each with its jacket number
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"prints": [
{
"chamber": "House",
"citation": "117-62",
"congress": 117,
"jacketNumber": 48144,
"number": "62",
"title": "RULES COMMITTEE PRINT 117-62",
"updateDate": "2022-08-01T21:19:33Z",
"url": "https://api.congress.gov/v3/committee-print/117/house/48144?format=json"
}
],
"total_count": 42
}List committee reports
Committee reports, newest first: the written accounts committees file when they report a bill out. Narrow to one Congress and series, or to conference reports only.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Report type
report_typetext - Narrow the list to one series. Needs a Congress as well. Leave empty for every type.One of:
hrpt(H.Rept.: House Report),srpt(S.Rept.: Senate Report),erpt(Ex.Rept.: Senate Executive Report). - Conference reports only
conferencetrue/false - Turn on to return only conference reports: the ones settling differences between the chambers.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
report_typetextreportslist- Committee reports, each with its citation
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"report_type": "hrpt",
"reports": [
{
"chamber": "House",
"citation": "H. Rept. 117-89",
"congress": 117,
"number": 89,
"part": 1,
"type": "HRPT",
"updateDate": "2022-02-18T16:38:41Z",
"url": "https://api.congress.gov/v3/committee-report/117/HRPT/89?format=json"
}
],
"total_count": 42
}List committees
Congressional committees and their subcommittees. Narrow to one chamber, one Congress, or both. Each entry carries the system code ('hspw00') that the other committee actions take.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Chamber
chambertext - Narrow the list to one chamber. Leave empty for all of them.One of:
house,senate,joint. - Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcommitteeslist- Committees, each with its system code and subcommittees
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"committees": [
{
"chamber": "House",
"committeeTypeCode": "Standing",
"name": "Transportation and Infrastructure Committee",
"subcommittees": [
{
"name": "Investigations and Oversight Subcommittee",
"systemCode": "hspw01",
"url": "https://api.congress.gov/v3/committee/house/hspw01?format=json"
}
],
"systemCode": "hspw00",
"url": "https://api.congress.gov/v3/committee/house/hspw00?format=json"
}
],
"congress": 119,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List congresses
Every Congress from the 1st to the one sitting now, with the years it sat and the start and end dates of each of its sessions.
Inputs
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congresseslist- Congresses, newest first
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"congresses": [
{
"endYear": "2026",
"name": "119th Congress",
"number": 119,
"sessions": [
{
"chamber": "House of Representatives",
"endDate": "2026-01-03",
"number": 1,
"startDate": "2025-01-03"
}
],
"startYear": "2025",
"url": "https://api.congress.gov/v3/congress/119?format=json"
}
],
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List Congressional Record issues
Issues of the Congressional Record with the PDF of each section: Daily Digest, House, Senate, Extensions of Remarks and the entire issue. Give a publication date for one day, or a year and month for a whole month.
Inputs
- Published on
published_ondate - The publication date to look up. Leave empty to filter by year and month instead, or to list the most recent issues.
- Year
yearnumber - The publication year, when you want a whole year or month rather than one day. Cannot be combined with a publication date.From 1789 to 2200.
- Month
monthnumber - The publication month, 1-12. Needs a year as well.From 1 to 12.
- Day
daynumber - The publication day, 1-31. Needs a year and month as well; usually easier to use the publication date instead.From 1 to 31.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
daynumberhas_moretrue/false- Whether another page follows
issueslist- Congressional Record issues with links to each section's PDF
limitnumber- Page size that was requested
monthnumbernext_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
yearnumber
Example output
{
"count": 1,
"day": 28,
"has_more": true,
"issues": [
{
"Congress": "117",
"Id": 26958,
"Issue": "109",
"Links": {
"FullRecord": {
"Label": "Entire Issue",
"Ordinal": 5,
"PDF": [
{
"Part": "1",
"Url": "https://www.congress.gov/117/crec/2022/06/28/168/109/CREC-2022-06-28.pdf"
}
]
}
},
"PublishDate": "2022-06-28",
"Session": "2",
"Volume": "168"
}
],
"limit": 20,
"month": 6,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"year": 2022
}List CRS reports
Congressional Research Service reports, newest first: the non-partisan analysis CRS writes for Congress on the issues before it. Filter by update date to follow new and revised reports.
Inputs
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
reportslist- CRS reports, each with its product number
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"reports": [
{
"contentType": "Reports",
"id": "R47175",
"publishDate": "2022-07-11T04:00:00Z",
"status": "Active",
"title": "Setting Budgetary Levels: The House's FY2023 Deeming Resolution",
"updateDate": "2025-06-20T23:46:23Z",
"url": "https://api.congress.gov/v3/crsreport/R47175",
"version": 1
}
],
"total_count": 42
}List daily Congressional Record
Issues of the daily Congressional Record, newest first. Narrow to one volume; there is one volume per year, 171 for 2025. Each entry carries the volume and issue numbers the issue actions take.
Inputs
- Volume
volume_numbernumber - Narrow to one volume: one per year, 171 for 2025. Leave empty for the most recent issues.At least 1.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
issueslist- Daily Congressional Record issues
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
volume_numbernumber
Example output
{
"count": 1,
"has_more": true,
"issues": [
{
"congress": "119",
"issueDate": "2025-01-03T05:00:00Z",
"issueNumber": "1",
"sessionNumber": "1",
"updateDate": "2025-01-04T16:59:21Z",
"url": "https://api.congress.gov/v3/daily-congressional-record/171/1?format=json",
"volumeNumber": "171"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"volume_number": 171
}List hearings
Published hearing transcripts. Narrow to one Congress and chamber. Each entry carries the jacket number 'Get hearing' takes.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Chamber
chambertext - Narrow the list to one chamber. Leave empty for all of them.One of:
house,senate,joint. - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
chambertextcongressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
hearingslist- Hearing transcripts, each with its jacket number
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"chamber": "house",
"congress": 118,
"count": 1,
"has_more": true,
"hearings": [
{
"chamber": "House",
"congress": 118,
"jacketNumber": 50896,
"updateDate": "2025-11-04T03:21:12Z",
"url": "https://api.congress.gov/v3/hearing/118/house/50896?format=json"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List House communications
Communications received by the House: the executive communications, memorials, presidential messages and petitions it logs and refers to committee. Narrow to one Congress and type.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Communication type
communication_typetext - Narrow to one kind of communication. Needs a Congress as well. Leave empty for every type.One of:
ec(Executive communication),ml(Memorial),pm(Presidential message),pt(Petition). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
communication_typetextcommunicationslist- House communications
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"communication_type": "ec",
"communications": [
{
"chamber": "House",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 118,
"number": "3324",
"referralDate": "2024-03-07",
"updateDate": "2024-09-03",
"url": "https://api.congress.gov/v3/house-communication/118/ec/3324?format=json"
}
],
"congress": 118,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List House reporting requirements
House reporting requirements: the standing obligations on federal agencies to report to the House, each with the number 'Get House reporting requirement' takes.
Inputs
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
countnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
requirementslist- House reporting requirements
total_countnumber- Records matching in all, across every page
Example output
{
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"requirements": [
{
"number": 8070,
"updateDate": "2021-08-13",
"url": "https://api.congress.gov/v3/house-requirement/8070?format=json"
}
],
"total_count": 42
}List House votes
House roll call votes, newest first, each with what was voted on, the result and the roll call number. Congress.gov holds House roll call votes from the 117th Congress onwards.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Session
sessiontext - Narrow the list to one session. Needs a Congress as well. Leave empty for both.One of:
1(First session (odd-numbered year)),2(Second session (even-numbered year)). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
sessionnumbertotal_countnumber- Records matching in all, across every page
voteslist- House roll call votes
Example output
{
"congress": 119,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"session": 1,
"total_count": 42,
"votes": [
{
"congress": 119,
"identifier": 1191202517,
"legislationNumber": "30",
"legislationType": "HR",
"legislationUrl": "https://congress.gov/bill/119/house-bill/30",
"result": "Passed",
"rollCallNumber": 17,
"sessionNumber": 1,
"sourceDataURL": "https://clerk.house.gov/evs/2025/roll017.xml",
"startDate": "2025-01-16T11:00:00-05:00",
"url": "https://api.congress.gov/v3/house-vote/119/1/17",
"voteType": "Yea-and-Nay"
}
]
}List laws
The bills that became law in one Congress. Narrow to public or private laws, or leave the type empty for both. Each entry carries the law number alongside the bill it came from.
Inputs
- Congress
congressnumberRequired - Which Congress the record belongs to. Pick from the list (the 119th Congress sits in 2025-2026).From 1 to 999.
- Law type
law_typetext - Public laws apply generally; private laws affect named individuals. Leave empty for both.One of:
pub(Public law),priv(Private law). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
law_typetextlawslist- Bills that became law, each with its law number
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 117,
"count": 1,
"has_more": true,
"law_type": "pub",
"laws": [
{
"congress": 117,
"introducedDate": "2021-05-11",
"latestAction": {
"actionDate": "2022-04-06",
"text": "Became Public Law No: 117-108."
},
"laws": [
{
"number": "117-108",
"type": "Public Law"
}
],
"number": "3076",
"originChamber": "House",
"originChamberCode": "H",
"title": "Postal Service Reform Act of 2022",
"type": "HR",
"updateDate": "2022-09-29",
"url": "https://api.congress.gov/v3/bill/117/hr/3076?format=json"
}
],
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List members
Members of Congress, most recently updated first. Narrow to one Congress, or turn on 'Currently serving only' for the members in office now. Each entry carries the bioguide id the member actions take.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Currently serving only
current_membertrue/false - Turn on to list only members in office now. Off includes everyone who has ever served.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
memberslist- Members, each with a bioguide id, party, state and portrait
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 119,
"count": 1,
"has_more": true,
"limit": 20,
"members": [
{
"bioguideId": "L000174",
"depiction": {
"attribution": "Courtesy U.S. Senate Historical Office",
"imageUrl": "https://www.congress.gov/img/member/l000174_200.jpg"
},
"name": "Leahy, Patrick J.",
"partyName": "Democratic",
"state": "Vermont",
"terms": {
"item": [
{
"chamber": "Senate",
"startYear": 1975
}
]
},
"updateDate": "2022-11-07T13:42:19Z",
"url": "https://api.congress.gov/v3/member/L000174?format=json"
}
],
"next_offset": 20,
"offset": 0,
"total_count": 42
}List members by state
Who represents a state (both senators and every representative) or, with a district number, the one member for that district. Add a Congress to ask who held the seat then rather than now.
Inputs
- State
state_codetextRequired - The two-letter postal code for the state or territory: MI for Michigan, DC for the District of Columbia.
- District
districtnumber - The House district number. Leave empty for everyone the state sends to Congress. Use 0 for a state with a single at-large district.From 0 to 99.
- Congress
congressnumber - Which Congress to ask about. Needs a district as well. Leave empty for the seat as it stands now.From 1 to 999.
- Currently serving only
current_membertrue/false - Turn on to list only members in office now. Off includes everyone who has ever served.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
districtnumberhas_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
memberslist- Members representing the state or district
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
state_codetexttotal_countnumber- Records matching in all, across every page
Example output
{
"congress": null,
"count": 1,
"district": 10,
"has_more": true,
"limit": 20,
"members": [
{
"bioguideId": "L000174",
"depiction": {
"attribution": "Courtesy U.S. Senate Historical Office",
"imageUrl": "https://www.congress.gov/img/member/l000174_200.jpg"
},
"name": "Leahy, Patrick J.",
"partyName": "Democratic",
"state": "Vermont",
"terms": {
"item": [
{
"chamber": "Senate",
"startYear": 1975
}
]
},
"updateDate": "2022-11-07T13:42:19Z",
"url": "https://api.congress.gov/v3/member/L000174?format=json"
}
],
"next_offset": 20,
"offset": 0,
"state_code": "MI",
"total_count": 42
}List nominations
Presidential nominations sent to the Senate, newest first, each with its PN citation, who was nominated and where it stands. Narrow to one Congress.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
nominationslist- Nominations, each with its PN citation
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"nominations": [
{
"citation": "PN2804",
"congress": 117,
"description": "Mary Anne Carter, of Tennessee, to be Chairperson of the National Endowment for the Arts for a term of four years.",
"latestAction": {
"actionDate": "2022-12-07",
"text": "Received in the Senate and referred to the Committee."
},
"nominationType": {
"isCivilian": true,
"isMilitary": false
},
"number": 2804,
"partNumber": "00",
"receivedDate": "2022-12-07",
"updateDate": "2022-12-08T05:25:17Z",
"url": "https://api.congress.gov/v3/nomination/117/2804?format=json"
}
],
"offset": 0,
"total_count": 42
}List Senate communications
Communications received by the Senate: executive communications, presidential messages, and petitions and memorials. Narrow to one Congress and type.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Communication type
communication_typetext - Narrow to one kind of communication. Needs a Congress as well. Leave empty for every type.One of:
ec(Executive communication),pm(Presidential message),pom(Petition or memorial). - Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
communication_typetextcommunicationslist- Senate communications
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
Example output
{
"communication_type": "ec",
"communications": [
{
"chamber": "Senate",
"communicationType": {
"code": "EC",
"name": "Executive Communication"
},
"congress": 118,
"number": "1615",
"referralDate": "2024-03-07",
"updateDate": "2024-09-03",
"url": "https://api.congress.gov/v3/senate-communication/117/ec/1615?format=json"
}
],
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42
}List treaties
Treaties sent to the Senate for advice and consent, newest first, each with its topic and the date it was transmitted. Narrow to one Congress.
Inputs
- Congress
congressnumber - Narrow the list to one Congress. Leave empty to search across all of them, newest first.From 1 to 999.
- Updated on or after
from_datetimedate and time - Only include records Congress.gov updated on or after this moment. Leave empty for no lower bound.
- Updated on or before
to_datetimedate and time - Only include records Congress.gov updated on or before this moment. Leave empty for no upper bound.
- Number of records
limitnumber - How many records to return, 1-250. Defaults to 20.From 1 to 250. Default:
20. - Skip
offsetnumber - How many records to skip before the first one returned; use the 'next_offset' from a previous run to read the next page. Defaults to 0.From 0 to 1000000. Default:
0.
Outputs
congressnumbercountnumber- Records on this page
has_moretrue/false- Whether another page follows
limitnumber- Page size that was requested
next_offsetnumber- Offset that reads the next page, or null at the end
offsetnumber- Records skipped before this page
total_countnumber- Records matching in all, across every page
treatieslist- Treaties before the Senate
Example output
{
"congress": 117,
"count": 1,
"has_more": true,
"limit": 20,
"next_offset": 20,
"offset": 0,
"total_count": 42,
"treaties": [
{
"congressConsidered": 117,
"congressReceived": 117,
"number": 3,
"suffix": "",
"topic": "Taxation",
"transmittedDate": "2021-05-17T00:00:00Z",
"updateDate": "2022-02-26T16:25:25Z",
"url": "https://api.congress.gov/v3/treaty/117/3?format=json"
}
]
}