US Congress CRS (Independent Publisher) (Preview)

A collection of endpoints to view, retrieve, and re-use machine-readable data from collections available on Congress.gov. Legislative activity only.

This connector is available in the following products and regions:

Service	Class	Regions
Copilot Studio	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Logic Apps	Standard	All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

Contact
Name	Dan Romano
URL	https://developments.substack.com
Email	dan.romano@swolcat.com

Connector Metadata
Publisher	Dan Romano
Website	https://api.congress.gov/
Privacy policy	https://api.govinfo.gov/docs/
Categories	Data

Creating a connection

The connector supports the following authentication types:


Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
API Key	securestring	Your API key for accessing the Congress.gov API.	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Amendment: Get a list of amendments by congress	Get a list of amendments filtered by congress, sorted by date of latest action
Amendment: Get a list of amendments by date of latest action	Example: https://api.congress.gov/v3/amendment?api_key=[INSERT_KEY]
Amendment: Get amendments by congress and amendment type	Example: https://api.congress.gov/v3/amendment/117/samdt?api_key=[INSERT_KEY]
Amendment: Get detailed info for a specified amendment	https://api.congress.gov/v3/amendment/117/samdt/2137?api_key=[INSERT_KEY]
Amendment: Get the list of actions on a specified amendment	https://api.congress.gov/v3/amendment/117/samdt/2137/actions?api_key=[INSERT_KEY]
Amendment: Get the list of amendments to a specified amendment	https://api.congress.gov/v3/amendment/117/samdt/2137/amendments?api_key=[INSERT_KEY]
Amendment: Get the list of cosponsors on a specified amendment	https://api.congress.gov/v3/amendment/117/samdt/2137/cosponsors?api_key=[INSERT_KEY]
Amendment: Get the list of text versions for a specified amendment	https://api.congress.gov/v3/amendment/117/hamdt/287/text?api_key=[INSERT_KEY]
Bills: Get a list of bills	https://api.congress.gov/v3/bill?api_key=[INSERT_KEY]
Bills: Get a list of bills by congress and bill type	https://api.congress.gov/v3/bill/117/hr?fromDateTime=2022-08-04T04:02:00Z&toDateTime=2022-09-30T04:03:00Z&sort=updateDate+asc&api_key=[INSERT_KEY]
Bills: Get a list of bills by congress and latest action date	https://api.congress.gov/v3/bill/117?fromDateTime=2022-08-04T04:02:00Z&toDateTime=2022-09-30T04:03:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]
Bills: Get detailed info for a specified bill	https://api.congress.gov/v3/bill/117/hr/3076?api_key=[INSERT_KEY]
Bills: Get the list of actions on a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/actions?api_key=[INSERT_KEY]
Bills: Get the list of amendments to a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/amendments?api_key=[INSERT_KEY]
Bills: Get the list of committees associated with a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/committees?api_key=[INSERT_KEY]
Bills: Get the list of cosponsors on a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/cosponsors?api_key=[INSERT_KEY]
Bills: Get the list of legislative subjects on a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/subjects?api_key=[INSERT_KEY]
Bills: Get the list of related bills to a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/relatedbills?api_key=[INSERT_KEY]
Bills: Get the list of text versions for a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/text?api_key=[INSERT_KEY]
Bills: Get the list of titles for a specified bill	https://api.congress.gov/v3/bill/117/hr/3076/titles?api_key=[INSERT_KEY]
Bound Congressional Record: Get a list of bound records	Get a list of bound Congressional Records sorted by date. Example Request: https://api.congress.gov/v3/bound-congressional-record?api_key=[INSERT_KEY]
Bound Congressional Record: Get bound records for a specified year and month	Retrieves a list of bound congressional records filtered by year and month. Example Request: https://api.congress.gov/v3/bound-congressional-record/1990/5?api_key=[INSERT_KEY]
Bound Congressional Record: Get bound records for a year, month, and day	Retrieves a list of bound congressional records filtered by year, month, and day. Example Request: https://api.congress.gov/v3/bound-congressional-record/1948/05/19?api_key=[INSERT_KEY]
Bound Congressional Records: Get bound records for a specified year	Retrieves a list of bound congressional records filtered by year. Example Request: https://api.congress.gov/v3/bound-congressional-record/1990?api_key=[INSERT_KEY]
Committee Meeting: Get a list of committee meetings	Get a list of committee meetings with details. Example Request: https://api.congress.gov/v3/committee-meeting?api_key=[INSERT_KEY]
Committee Meeting: Get a list of committee meetings by congress	https://api.congress.gov/v3/committee-meeting/118?api_key=[INSERT_KEY]
Committee Meeting: Get committee meetings for a Congress session and chamber	Get a list of committee meetings filtered by Congress session and chamber. Example Request: https://api.congress.gov/v3/committee-meeting/118/house?api_key=[INSERT_KEY]
Committee Meeting: Get detailed inf for a specified committee meeting	Retrieves a detailed record of a committee meeting filtered by Congress session, chamber, and event ID. Example Request: https://api.congress.gov/v3/committee-meeting/118/house/115538?api_key=[INSERT_KEY]
Committee Print: Get a list of committee prints	Get a list of committee prints, filtered by optional parameters such as format, date range, and pagination. Example Request: https://api.congress.gov/v3/committee-print?api_key=[INSERT_KEY]
Committee Print: Get committee prints for a specific congress	Get a list of committee prints for a given congress session. Example Request: https://api.congress.gov/v3/committee-print/117?api_key=[INSERT_KEY]
Committee Print: Get committee prints for a specific congress and chamber	Get a list of committee prints for a given congress session and chamber. Example Request: https://api.congress.gov/v3/committee-print/117/house?api_key=[INSERT_KEY]
Committee Print: Get detailed info for a specific committee print	Retrieves details of a committee print for a given congress session, chamber, and jacket number. Example Request: https://api.congress.gov/v3/committee-print/117/house/48144?api_key=[INSERT_KEY]
Committee Print: Get the text versions of a specified committee print	Get a list of text versions for a given committee print identified by congress, chamber, and jacket number. Example Request: https://api.congress.gov/v3/committee-print/117/house/48144/text?api_key=[INSERT_KEY]
Committee Report: Get a list of committee reports	Get a list of committee reports with optional filters for format, date range, and pagination.
Committee Report: Get committee reports filtered by congress	Get a list of committee reports from a specified congress session with optional filters. Example Request: https://api.congress.gov/v3/committee-report/116?conference=true&api_key=[INSERT_KEY]
Committee Report: Get committee reports for a given congress and report type	Get a list of committee reports filtered by congress and report type. Example Request: https://api.congress.gov/v3/committee-report/116/hrpt?conference=true&api_key=[INSERT_KEY]
Committee Report: Get detailed info for a specified committee report	Retrieves detailed info for a specific committee report by congress, report type, and report number. Example Request: https://api.congress.gov/v3/committee-report/116/HRPT/617?api_key=[INSERT_KEY]
Committee Report: Get the full text of a specified committee report	Retrieves the full text of a committee report for a given congress session, report type, and report number. Example Request: https://api.congress.gov/v3/committee-report/116/hrpt/617/text?api_key=[INSERT_KEY]
Committee: Get a list of committee reports for a congressional committee	Example request: https://api.congress.gov/v3/committee/house/hspw00/reports?api_key=[INSERT_KEY]
Committee: Get a list of congressional committees	Example request: https://api.congress.gov/v3/committee?api_key=[INSERT_KEY]
Committee: Get a list of congressional committees filtered by chamber	Example request: https://api.congress.gov/v3/committee/house?api_key=[INSERT_KEY]
Committee: Get a list of House communications for a congressional committee	Example request: https://api.congress.gov/v3/committee/house/hspw00/house-communication?api_key=[INSERT_KEY]
Committee: Get a list of legislation associated with a congressional committee	Example request: https://api.congress.gov/v3/committee/house/hspw00/bills?api_key=[INSERT_KEY]
Committee: Get a list of nominations for a specified congressional committee	Example request: https://api.congress.gov/v3/committee/senate/ssas00/nominations?format=json&api_key=[INSERT_KEY]
Committee: Get a list of Senate communications for a congressional committee	Example request: https://api.congress.gov/v3/committee/senate/ssas00/senate-communication?api_key=[INSERT_KEY]
Committee: Get detailed info for a specified congressional committee	Example request: https://api.congress.gov/v3/committee/details/house/hspw00?api_key=[INSERT_KEY]
Congress: Get a list of congresses and congressional sessions	https://api.congress.gov/v3/congress?api_key=[INSERT_KEY]
Congress: Get detailed info for a specified congress	https://api.congress.gov/v3/congress/116?api_key=[INSERT_KEY]
Congress: Get detailed info for the current congress	https://api.congress.gov/v3/congress/current?api_key=[INSERT_KEY]
Congressional Record: Get a list of congressional record issues	Get a list of Congressional Record issues sorted by most recent. Example: https://api.congress.gov/v3/congressional-record/?y=2022&m=6&d=28&api_key=[INSERT_KEY]
CRS Report: Get CRS Reports	Retrieve a list of CRS reports available in Congress.gov, sorted by the most recent updates
CRS Report: Get details for a specific CRS report	Retrieve detailed metadata for a specific CRS report using its report ID
Daily Congressional Record: Get a list of daily issues by volume number	Get a list of daily congressional record issues filtered by the specified volume number. Example: https://api.congress.gov/v3/daily-congressional-record/166?api_key=[INSERT_KEY]
Daily Congressional Record: Get a list of daily record issues	Get a list of daily congressional record issues sorted by date.
Daily Congressional Record: Get daily articles by volume and issue	Get a list of articles from the daily congressional record based on the specified volume and issue number. Example: https://api.congress.gov/v3/daily-congressional-record/167/21/articles?api_key=[INSERT_KEY]
Daily Congressional Record: Get daily issues by volume and issue number	Get a list of daily congressional record issues filtered by the specified volume and issue number. Example: https://api.congress.gov/v3/daily-congressional-record/166/92?api_key=[INSERT_KEY]
Hearing: Get a list of congressional hearings	Get a list of congressional hearings, including metadata such as dates, committees, and hearing titles. Example: https://api.congress.gov/v3/hearing?api_key=[INSERT_KEY]
Hearing: Get a list of hearings filtered by congress	Get a list of congressional hearings for a specific Congress session. Example: https://api.congress.gov/v3/hearing/116?api_key=[INSERT_KEY]
Hearing: Get a list of hearings filtered by congress and chamber	Get a list of congressional hearings for a specific Congress session and chamber. Example: https://api.congress.gov/v3/hearing/116/house?api_key=[INSERT_KEY]
Hearing: Get detailed info for a specified hearing	Retrieves detailed hearing information for a specific Congress session, chamber, and jacket number. Example: https://api.congress.gov/v3/hearing/116/house/41365?api_key=[INSERT_KEY]
House Communication: Get detailed info for a specified House communication	Retrieves detailed info for a specific House communication identified by Congress session, communication type, and communication number. Example Request: https://api.congress.gov/v3/house-communication/117/ec/3324?api_key=[INSERT_KEY]
House Communication: Get House communications by Congress session and comm type	Retrieves a list of House communications filtered by Congress session and communication type. Example Request: https://api.congress.gov/v3/house-communication/117/ec?api_key=[INSERT_KEY]
House Communication: Get House communications for a specified Congress session	Retrieves a list of House communications recorded in a specific Congress session. Example Request: https://api.congress.gov/v3/house-communication/117?api_key=[INSERT_KEY]
House Communication: Retrieves a list of House communications	Retrieves a list of House communications recorded in the Congressional system.
House Requirement: Get a list of House requirements	Retrieves a list of House requirements as defined by Congress. Example Request: https://api.congress.gov/v3/house-requirement?api_key=[INSERT_KEY]
House Requirement: Get detailed info for a specific House requirement	Retrieves detailed info about a specific House requirement by its assigned number. Example Request: https://api.congress.gov/v3/house-requirement/8070?api_key=[INSERT_KEY]
House Requirement: Get matching comms for a specific House requirement	Retrieves a list of communications that match a specified House requirement. Example Request: https://api.congress.gov/v3/house-requirement/8070/matching-communications?api_key=[INSERT_KEY]
Laws: Get a law filtered by specified congress, law type, and law number	https://api.congress.gov/v3/law/117/pub/108?api_key=[INSERT_KEY]
Laws: Get a list of laws filtered by congress	https://api.congress.gov/v3/law/118?api_key=[INSERT_KEY]
Laws: Get a list of laws filtered by congress and law type	https://api.congress.gov/v3/law/118/pub?api_key=[INSERT_KEY]
Member: Get a list of congressional members	https://api.congress.gov/v3/member?api_key=[INSERT_KEY]
Member: Get a list of legislation cosponsored by a congressional member	https://api.congress.gov/v3/member/L000174/cosponsored-legislation?api_key=[INSERT_KEY]
Member: Get a list of legislation sponsored by a congressional member	https://api.congress.gov/v3/member/L000174/sponsored-legislation?api_key=[INSERT_KEY]
Member: Get a list of members filtered by congress, state and district	https://api.congress.gov/v3/member/congress/97/TX/10?currentMember=False&api_key=[INSERT_KEY]
Member: Get a list of members filtered by state and district	Example request: https://api.congress.gov/v3/member/MI/10?api_key=[INSERT_KEY]
Member: Get detailed info for a specified congressional member	https://api.congress.gov/v3/member/L000174?api_key=[INSERT_KEY]
Member: Get the list of members specified by Congress	Example request: https://api.congress.gov/v3/member/congress/118?api_key=[INSERT_KEY] Previous Congress: https://api.congress.gov/v3/member/congress/117?currentMember=False&api_key=[INSERT_KEY]
Nomination: Get actions on a specified nomination	Retrieves all recorded actions taken on a specific nomination, such as committee referrals, hearings, and votes. Example: https://api.congress.gov/v3/nomination/117/2467/actions?api_key=[INSERT_KEY]
Nomination: Get committees associated with a specified nomination	Retrieves all congressional committees assigned to evaluate or process a specific nomination. Example: https://api.congress.gov/v3/nomination/117/2467/committees?api_key=[INSERT_KEY]
Nomination: Get detailed info for a specified nomination	Retrieves details for a specific nomination, including nominee name, position, agency, and status. Example: https://api.congress.gov/v3/nomination/117/2467?api_key=[INSERT_KEY]
Nomination: Get nominations	https://api.congress.gov/v3/nomination?api_key=[INSERT_KEY]
Nomination: Get nominations by congress and date from the President	Get a list of nominations submitted by the President for a specific Congress, filtered by date. Example: https://api.congress.gov/v3/nomination/117?api_key=[INSERT_KEY]
Nomination: Get printed hearings associated with a nomination	Retrieves all printed hearings related to a specific nomination. Example: https://api.congress.gov/v3/nomination/116/389/hearings?api_key=[INSERT_KEY]
Retrieve a list of Senate communications	Retrieves a list of Senate communications. Example Request: https://api.congress.gov/v3/senate-communication?api_key=[INSERT_KEY]
Senate Communication: Get details for a specified Senate communication	Retrieves detailed information for a Senate communication filtered by Congress session, communication type, and assigned number. Example Request: https://api.congress.gov/v3/senate-communication/117/ec/2561?api_key=[INSERT_KEY]
Senate Communication: Get Senate comms by Congress session and type	Retrieves a list of Senate communications filtered by Congress session and communication type. Example Request: https://api.congress.gov/v3/senate-communication/117/ec?api_key=[INSERT_KEY]
Senate Communication: Get Senate comms for a specified Congress session	Retrieves a list of Senate communications filtered by Congress session. Example Request: https://api.congress.gov/v3/senate-communication/117?api_key=[INSERT_KEY]
Summaries: Get summaries by congress and bill type	https://api.congress.gov/v3/summaries/117/hr?fromDateTime=2022-04-01T00:00:00Z&toDateTime=2022-04-03T00:00:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]
Summaries: Get summaries filtered by congress	https://api.congress.gov/v3/summaries/117?fromDateTime=2022-04-01T00:00:00Z&toDateTime=2022-04-03T00:00:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]
Treaty: Get actions on a specified treaty	Retrieves the actions taken on a treaty for a given congress session and treaty number. Example: https://api.congress.gov/v3/treaty/117/3/actions?api_key=[INSERT_KEY]
Treaty: Get committees associated with a specified treaty	Retrieves the committees that are reviewing or have reviewed a specified treaty in a given Congress session. Example: https://api.congress.gov/v3/treaty/116/3/committees?api_key=[INSERT_KEY]
Treaty: Get detailed info for a specified partitioned treaty	Retrieves detailed treaty information for a given congress session, treaty number, and partition letter. Example: https://api.congress.gov/v3/treaty/114/13/A?api_key=[INSERT_KEY]
Treaty: Get detailed info for a specified treaty	Retrieves detailed treaty information for a given congress session and treaty number. Example: https://api.congress.gov/v3/treaty/117/3?api_key=[INSERT_KEY]
Treaty: Get the list of actions on a specified partitioned treaty	Retrieves the actions taken on a partitioned treaty for a given congress session, treaty number, and suffix. Example: https://api.congress.gov/v3/treaty/114/13/A/actions?api_key=[INSERT_KEY]
Treaty: Get treaties	Get a list of treaties available in Congress.gov, sorted by the most recent updates. Example: https://api.congress.gov/v3/treaty?api_key=[INSERT_KEY]
Treaty: Get treaties for the specified congress	Retrieves treaties associated with a specific congress, sorted by the most recent updates. Example request: https://api.congress.gov/v3/treaty/117?api_key=[INSERT_KEY]

Amendment: Get a list of amendments by congress

Operation ID:: AmendmentCongress

Get a list of amendments filtered by congress, sorted by date of latest action

Parameters

Name	Key	Required	Type	Description
Congress number	congress	True	integer	The congress number. For example, the value can be 117
Data format (XML/JSON)	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Records returned limit	limit		integer	The number of records returned. The maximum limit is 250
Starting timestamp	fromDateTime		date-time	Start timestamp by updated date. Use format: YYYY-MM-DDT00:00:00Z
Ending timestamp	toDateTime		date-time	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
amendments	amendments	array of object
congress	amendments.congress	integer
number	amendments.number	string
type	amendments.type	string
updateDate	amendments.updateDate	date-time
url	amendments.url	uri

Amendment: Get a list of amendments by date of latest action

Operation ID:: Amendment

Example: https://api.congress.gov/v3/amendment?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Data format (XML/JSON)	format	string	The data format. Value can be xml or json
Offset	offset	integer	The starting record returned. 0 is the first record
Records returned limit	limit	integer	The number of records returned. The maximum limit is 250
Starting timestamp	fromDateTime	date-time	Starting timestamp for updated date YYYY-MM-DDT00:00:00Z
Ending timestamp	toDateTime	date-time	Ending timestamp for updated date YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
amendments	amendments	array of object
congress	amendments.congress	integer
number	amendments.number	string
type	amendments.type	string
updateDate	amendments.updateDate	date-time
url	amendments.url	uri

Amendment: Get amendments by congress and amendment type

Operation ID:: AmendmentList

Example: https://api.congress.gov/v3/amendment/117/samdt?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
The congress number	congress	True	integer	The congress number. For example, the value can be 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt, samdt, or suamdt
Data format (XML/JSON)	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Records returned limit	limit		integer	The number of records returned. The maximum limit is 250
See description	fromDateTime		date-time	Starting timestamp for update date. YYYY-MM-DDT00:00:00Z
See description	toDateTime		date-time	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
amendments	amendments	array of object
congress	amendments.congress	integer
number	amendments.number	string
type	amendments.type	string
updateDate	amendments.updateDate	date-time
url	amendments.url	uri

Amendment: Get detailed info for a specified amendment

Operation ID:: AmendmentDetails

https://api.congress.gov/v3/amendment/117/samdt/2137?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
The congress number. For example, the value can be 117	congress	True	integer	The congress number. For example, the value can be 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt, samdt, or suamdt
The amendment's assigned number. Example: 2137	amendmentNumber	True	integer	The amendment's assigned number. Example: 2137
Data format (XML/JSON)	format		string	The data format. Value can be xml or json

Returns

Name	Path	Type
congress	congress	integer
number	number	string
type	type	string
proposedDate	proposedDate	date-time
submittedDate	submittedDate	date-time
updateDate	updateDate	date-time
purpose	purpose	string
chamber	chamber	string
actionDate	latestAction.actionDate	date
text	latestAction.text	string
sponsors	sponsors	array of object
bioguideId	sponsors.bioguideId	string
firstName	sponsors.firstName	string
fullName	sponsors.fullName	string
lastName	sponsors.lastName	string
url	sponsors.url	uri
count	cosponsors.count	integer
countIncludingWithdrawnCosponsors	cosponsors.countIncludingWithdrawnCosponsors	integer
url	cosponsors.url	uri
url	url	uri

Amendment: Get the list of actions on a specified amendment

Operation ID:: AmendmentActions

https://api.congress.gov/v3/amendment/117/samdt/2137/actions?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
The congress number. For example, the value can be 117	congress	True	integer	The congress number. For example, the value can be 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt, samdt, or suamdt
The amendment's assigned number. For example, the value can be 2137	amendmentNumber	True	integer	The amendment's assigned number. For example, the value can be 2137
See description	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Records returned limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
actions	actions	array of object
actionDate	actions.actionDate	date-time
text	actions.text	string
type	actions.type	string
recordedVotes	actions.recordedVotes	array of object
chamber	actions.recordedVotes.chamber	string
congress	actions.recordedVotes.congress	integer
date	actions.recordedVotes.date	date-time
rollNumber	actions.recordedVotes.rollNumber	integer
sessionNumber	actions.recordedVotes.sessionNumber	integer
url	actions.recordedVotes.url	uri
code	actions.sourceSystem.code	integer
name	actions.sourceSystem.name	string

Amendment: Get the list of amendments to a specified amendment

Operation ID:: AmendmentAmendments

https://api.congress.gov/v3/amendment/117/samdt/2137/amendments?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. For example, the value can be 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt, samdt, or suamdt
Amendment Number	amendmentNumber	True	integer	The amendment's assigned number. For example, the value can be 2137
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Amendment: Get the list of cosponsors on a specified amendment

Operation ID:: AmendmentCosponsors

https://api.congress.gov/v3/amendment/117/samdt/2137/cosponsors?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
See description	congress	True	integer	The congress number. For example, the value can be 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt, samdt, or suamdt
See description	amendmentNumber	True	integer	The amendment's assigned number. For example, the value can be 2137
See description	format		string	The data format. Value can be xml or json
See description	offset		integer	The starting record returned. 0 is the first record
See description	limit		integer	The number of records returned. The maximum limit is 250

Amendment: Get the list of text versions for a specified amendment

Operation ID:: AmendmentsText

https://api.congress.gov/v3/amendment/117/hamdt/287/text?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. This endpoint is for the 117th Congress and onwards. Example: 117
Amendment Type	amendmentType	True	string	The type of amendment. Value can be hamdt or samdt
Amendment Number	amendmentNumber	True	integer	The amendment's assigned number. For example, the value can be 287
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
textVersions	textVersions	array of object
date	textVersions.date	date-time
type	textVersions.type	string
formats	textVersions.formats	array of object
type	textVersions.formats.type	string
url	textVersions.formats.url	uri

Bills: Get a list of bills

Operation ID:: BillListAll

https://api.congress.gov/v3/bill?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Format	format	string	The data format. Value can be xml or json
See description	offset	integer	The starting record returned. 0 is the first record
See description	limit	integer	The number of records returned. The maximum limit is 250
See description	fromDateTime	string	Starting timestampe for update date. Use YYYY-MM-DDT00:00:00Z
See description	toDateTime	string	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z
See description	sort	string	Sort by update date in Congress.gov. Value can be updateDate+asc or updateDate+desc

Returns

Name	Path	Type
bills	bills	array of object
congress	bills.congress	integer
actionDate	bills.latestAction.actionDate	date
text	bills.latestAction.text	string
number	bills.number	string
originChamber	bills.originChamber	string
originChamberCode	bills.originChamberCode	string
title	bills.title	string
type	bills.type	string
updateDate	bills.updateDate	date
updateDateIncludingText	bills.updateDateIncludingText	date-time
url	bills.url	uri

Bills: Get a list of bills by congress and bill type

Operation ID:: BillListByType

https://api.congress.gov/v3/bill/117/hr?fromDateTime=2022-08-04T04:02:00Z&toDateTime=2022-09-30T04:03:00Z&sort=updateDate+asc&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. For example, the value can be 117
Bill Type	billType	True	string	The type of bill. Value can be hr, s, hjres, sjres, hconres, sconres, hres, or sres
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250
Starting Timestamp	fromDateTime		date-time	Starting timestamp for update date. Use YYYY-MM-DDT00:00:00Z
Ending Timestamp	toDateTime		date-time	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z
Sorting Order	sort		string	Sort by update date in Congress.gov. Value can be updateDate+asc or updateDate+desc

Returns

Name	Path	Type
bills	bills	array of object
congress	bills.congress	integer
number	bills.number	string
type	bills.type	string
title	bills.title	string
originChamber	bills.originChamber	string
originChamberCode	bills.originChamberCode	string
actionDate	bills.latestAction.actionDate	date-time
text	bills.latestAction.text	string
updateDate	bills.updateDate	date-time
url	bills.url	uri

Bills: Get a list of bills by congress and latest action date

Operation ID:: BillListByCongress

https://api.congress.gov/v3/bill/117?fromDateTime=2022-08-04T04:02:00Z&toDateTime=2022-09-30T04:03:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
See description	congress	True	integer	The congress number. For example, the value can be 117
See description	format		string	The data format. Value can be xml or json
See description	offset		integer	The starting record returned. 0 is the first record
See description	limit		integer	The number of records returned. The maximum limit is 250
See description	fromDateTime		string	Starting timestampe for update date. Use YYYY-MM-DDT00:00:00Z
See description	toDateTime		string	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z
See description	sort		string	Sort by update date in Congress.gov. Value can be updateDate+asc or updateDate+desc

Returns

Name	Path	Type
bills	bills	array of object
congress	bills.congress	integer
actionDate	bills.latestAction.actionDate	date
text	bills.latestAction.text	string
number	bills.number	string
originChamber	bills.originChamber	string
originChamberCode	bills.originChamberCode	string
title	bills.title	string
type	bills.type	string
updateDate	bills.updateDate	date
updateDateIncludingText	bills.updateDateIncludingText	date-time
url	bills.url	uri

Bills: Get detailed info for a specified bill

Operation ID:: BillDetails

https://api.congress.gov/v3/bill/117/hr/3076?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill. Value can be hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json

Returns

Name	Path	Type
congress	bill.congress	integer
number	bill.number	string
type	bill.type	string
title	bill.title	string
originChamber	bill.originChamber	string
originChamberCode	bill.originChamberCode	string
actionDate	bill.latestAction.actionDate	date-time
text	bill.latestAction.text	string
updateDate	bill.updateDate	date-time
url	bill.url	uri

Bills: Get the list of actions on a specified bill

Operation ID:: BillActions

https://api.congress.gov/v3/bill/117/hr/3076/actions?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
actions	actions	array of object
actionDate	actions.actionDate	date-time
text	actions.text	string
type	actions.type	string
recordedVotes	actions.recordedVotes	array of object
chamber	actions.recordedVotes.chamber	string
congress	actions.recordedVotes.congress	integer
date	actions.recordedVotes.date	date-time
rollNumber	actions.recordedVotes.rollNumber	integer
sessionNumber	actions.recordedVotes.sessionNumber	integer
url	actions.recordedVotes.url	uri
code	actions.sourceSystem.code	integer
name	actions.sourceSystem.name	string

Bills: Get the list of amendments to a specified bill

Operation ID:: BillAmendments

https://api.congress.gov/v3/bill/117/hr/3076/amendments?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
amendments	amendments	array of object
congress	amendments.congress	integer
number	amendments.number	string
type	amendments.type	string
date	amendments.latestAction.date	date-time
text	amendments.latestAction.text	string
updateDate	amendments.updateDate	date-time
url	amendments.url	uri

Bills: Get the list of committees associated with a specified bill

Operation ID:: BillCommittees

https://api.congress.gov/v3/bill/117/hr/3076/committees?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
committees	committees	array of object
chamber	committees.chamber	string
committeeCode	committees.committeeCode	string
committeeName	committees.committeeName	string
subcommitteeCode	committees.subcommitteeCode	string
subcommitteeName	committees.subcommitteeName	string
url	committees.url	uri

Bills: Get the list of cosponsors on a specified bill

Operation ID:: BillCosponsors

https://api.congress.gov/v3/bill/117/hr/3076/cosponsors?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
cosponsors	cosponsors	array of object
bioguideId	cosponsors.bioguideId	string
firstName	cosponsors.firstName	string
lastName	cosponsors.lastName	string
fullName	cosponsors.fullName	string
party	cosponsors.party	string
state	cosponsors.state	string
sponsorshipDate	cosponsors.sponsorshipDate	date
isOriginalCosponsor	cosponsors.isOriginalCosponsor	boolean
url	cosponsors.url	uri

Bills: Get the list of legislative subjects on a specified bill

Operation ID:: BillSubjects

https://api.congress.gov/v3/bill/117/hr/3076/subjects?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250
Start Date	fromDateTime		string	Starting timestamp for update date. Use YYYY-MM-DDT00:00:00Z
End Date	toDateTime		string	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
subjects	subjects	array of object
name	subjects.name	string
url	subjects.url	uri

Operation ID:: BillRelatedbills

https://api.congress.gov/v3/bill/117/hr/3076/relatedbills?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
relatedBills	relatedBills	array of object
congress	relatedBills.congress	integer
number	relatedBills.number	string
type	relatedBills.type	string
relationType	relatedBills.relationType	string
updateDate	relatedBills.updateDate	date-time
url	relatedBills.url	uri

Bills: Get the list of text versions for a specified bill

Operation ID:: BillText

https://api.congress.gov/v3/bill/117/hr/3076/text?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
textVersions	textVersions	array of object
date	textVersions.date	date-time
formats	textVersions.formats	array of object
type	textVersions.formats.type	string
url	textVersions.formats.url	uri
updateDate	textVersions.updateDate	date-time

Bills: Get the list of titles for a specified bill

Operation ID:: BillTitles

https://api.congress.gov/v3/bill/117/hr/3076/titles?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress	congress	True	integer	The congress number. Example: 117
Bill Type	billType	True	string	The type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Bill Number	billNumber	True	integer	The bill's assigned number. Example: 3076
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	The starting record returned. 0 is the first record
Limit	limit		integer	The number of records returned. The maximum limit is 250

Returns

Name	Path	Type
titles	titles	array of object
title	titles.title	string
titleType	titles.titleType	string
isOfficialTitle	titles.isOfficialTitle	boolean
date	titles.date	date-time

Bound Congressional Record: Get a list of bound records

Operation ID:: BoundCongressionalRecordList

Get a list of bound Congressional Records sorted by date.

Example Request:

https://api.congress.gov/v3/bound-congressional-record?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of bound Congressional Records
volume	results.volume	integer	The volume number of the bound Congressional Record
issue	results.issue	integer	The issue number of the bound Congressional Record
issueDate	results.issueDate	date	The date of the bound Congressional Record issue
url	results.url	uri	URL to the bound Congressional Record issue

Bound Congressional Record: Get bound records for a specified year and month

Operation ID:: BoundCongressionalRecordListByYearAndMonth

Retrieves a list of bound congressional records filtered by year and month.

Example Request:

https://api.congress.gov/v3/bound-congressional-record/1990/5?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Year of the bound Congressional record	year	True	integer	The specified year of the bound Congressional record. Example: 1990
Month of the bound Congressional record	month	True	integer	The specified month of the bound Congressional record. Example: 5 for May
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of bound congressional records
title	results.title	string	Title of the bound congressional record
volume	results.volume	integer	Volume number of the bound congressional record
part	results.part	integer	Part number of the bound congressional record
year	results.year	integer	The year of the record
month	results.month	integer	The month of the record
url	results.url	uri	URL to the bound congressional record

Bound Congressional Record: Get bound records for a year, month, and day

Operation ID:: BoundCongressionalRecordListByYearMonthDay

Retrieves a list of bound congressional records filtered by year, month, and day.

Example Request:

https://api.congress.gov/v3/bound-congressional-record/1948/05/19?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Year of the bound Congressional record	year	True	integer	The specified year of the bound Congressional record. Example: 1948
Month of the bound Congressional record	month	True	integer	The specified month of the bound Congressional record. Example: 5 for May
Day of the bound Congressional record	day	True	integer	The specified day of the bound Congressional record. Example: 19
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of bound congressional records
title	results.title	string	Title of the bound congressional record
volume	results.volume	integer	Volume number of the bound congressional record
part	results.part	integer	Part number of the bound congressional record
year	results.year	integer	The year of the record
month	results.month	integer	The month of the record
day	results.day	integer	The day of the record
url	results.url	uri	URL to the bound congressional record

Bound Congressional Records: Get bound records for a specified year

Operation ID:: BoundCongressionalRecordListByYear

Retrieves a list of bound congressional records filtered by year.

Example Request:

https://api.congress.gov/v3/bound-congressional-record/1990?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Year of the bound Congressional record	year	True	integer	The specified year of the bound Congressional record. Example: 1990
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of bound congressional records
title	results.title	string	Title of the bound congressional record
volume	results.volume	integer	Volume number of the bound congressional record
part	results.part	integer	Part number of the bound congressional record
year	results.year	integer	The year of the record
url	results.url	uri	URL to the bound congressional record

Committee Meeting: Get a list of committee meetings

Operation ID:: CommitteeMeetingList

Get a list of committee meetings with details.

Example Request:

https://api.congress.gov/v3/committee-meeting?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of committee meetings available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee meetings
meetingId	results.meetingId	string	Unique identifier for the meeting
date	results.date	date	Date of the committee meeting
chamber	results.chamber	string	The chamber where the meeting is held (House/Senate)
committee	results.committee	string	The name of the committee conducting the meeting
url	results.url	uri	URL to the committee meeting details

Committee Meeting: Get a list of committee meetings by congress

Operation ID:: CommitteeMeetingCongress

https://api.congress.gov/v3/committee-meeting/118?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
See description	congress	True	integer	The congress number. For example, the value can be 118
See description	format		string	The data format. Value can be xml or json
See description	offset		integer	The starting record returned. 0 is the first record
See description	limit		integer	The number of records returned. The maximum limit is 250

Committee Meeting: Get committee meetings for a Congress session and chamber

Operation ID:: CommitteeMeetingCongressChamber

Get a list of committee meetings filtered by Congress session and chamber.

Example Request:

https://api.congress.gov/v3/committee-meeting/118/house?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 118
Congress chamber	chamber	True	string	The chamber where the meeting is held. Accepted values: house, senate, nochamber
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of committee meetings available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee meetings
meetingId	results.meetingId	string	Unique identifier for the meeting
date	results.date	date	Date of the committee meeting
chamber	results.chamber	string	The chamber where the meeting is held (House/Senate)
committee	results.committee	string	The name of the committee conducting the meeting
url	results.url	uri	URL to the committee meeting details

Committee Meeting: Get detailed inf for a specified committee meeting

Operation ID:: CommitteeMeetingDetail

Retrieves a detailed record of a committee meeting filtered by Congress session, chamber, and event ID.

Example Request:

https://api.congress.gov/v3/committee-meeting/118/house/115538?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 118
Congress chamber	chamber	True	string	The chamber where the meeting is held. Accepted values: house, senate, nochamber
Committee meeting event ID	eventId	True	string	The unique event identifier assigned to the meeting. Example: 115538
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
eventId	eventId	string	Unique identifier for the committee meeting
date	date	date	Date of the committee meeting
chamber	chamber	string	The chamber where the meeting is held (House/Senate)
committee	committee	string	The name of the committee conducting the meeting
title	title	string	The title of the meeting
location	location	string	Location where the meeting is held
url	url	uri	URL to the committee meeting details

Committee Print: Get a list of committee prints

Operation ID:: CommitteePrintList

Get a list of committee prints, filtered by optional parameters such as format, date range, and pagination.

Example Request:

https://api.congress.gov/v3/committee-print?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.
Start date filter	fromDateTime	string	Filters results based on update timestamp, starting from this date. Use format: YYYY-MM-DDT00:00:00Z
End date filter	toDateTime	string	Filters results based on update timestamp, ending at this date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type	Description
count	count	integer	Total number of committee prints available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee prints
committeePrintId	results.committeePrintId	string	Unique identifier for the committee print
congress	results.congress	integer	The Congress session number
chamber	results.chamber	string	The chamber in which the committee print originated (House, Senate, or Joint)
title	results.title	string	Title of the committee print
updateDate	results.updateDate	date-time	The date the committee print was last updated
url	results.url	uri	URL to the committee print

Committee Print: Get committee prints for a specific congress

Operation ID:: CommitteePrintsByCongress

Get a list of committee prints for a given congress session.

Example Request:

https://api.congress.gov/v3/committee-print/117?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The congress number. Example: 117
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.
Start date filter	fromDateTime		string	Filters results based on update timestamp, starting from this date. Use format: YYYY-MM-DDT00:00:00Z
End date filter	toDateTime		string	Filters results based on update timestamp, ending at this date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type	Description
count	count	integer	Total number of committee prints available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee prints
committeePrintId	results.committeePrintId	string	Unique identifier for the committee print
congress	results.congress	integer	The Congress session number
chamber	results.chamber	string	The chamber in which the committee print originated (House, Senate, or Joint)
title	results.title	string	Title of the committee print
updateDate	results.updateDate	date-time	The date the committee print was last updated
url	results.url	uri	URL to the committee print

Committee Print: Get committee prints for a specific congress and chamber

Operation ID:: CommitteePrintsByCongressChamber

Get a list of committee prints for a given congress session and chamber.

Example Request:

https://api.congress.gov/v3/committee-print/117/house?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The congress number. Example: 117
Congressional chamber	chamber	True	string	The chamber name. Accepted values: house, senate, nochamber
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.
Start date filter	fromDateTime		string	Filters results based on update timestamp, starting from this date. Use format: YYYY-MM-DDT00:00:00Z
End date filter	toDateTime		string	Filters results based on update timestamp, ending at this date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type	Description
count	count	integer	Total number of committee prints available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee prints
committeePrintId	results.committeePrintId	string	Unique identifier for the committee print
congress	results.congress	integer	The Congress session number
chamber	results.chamber	string	The chamber in which the committee print originated (House, Senate, or Joint)
title	results.title	string	Title of the committee print
updateDate	results.updateDate	date-time	The date the committee print was last updated
url	results.url	uri	URL to the committee print

Committee Print: Get detailed info for a specific committee print

Operation ID:: CommitteePrintDetail

Retrieves details of a committee print for a given congress session, chamber, and jacket number.

Example Request:

https://api.congress.gov/v3/committee-print/117/house/48144?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The congress number. Example: 117
Congressional chamber	chamber	True	string	The chamber name. Accepted values: house, senate, nochamber
Jacket number	jacketNumber	True	integer	The unique jacket number assigned to the committee print. Example: 48144
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
committeePrintId	committeePrintId	string	Unique identifier for the committee print
congress	congress	integer	The Congress session number
chamber	chamber	string	The chamber in which the committee print originated (House, Senate, or Joint)
jacketNumber	jacketNumber	integer	The unique jacket number of the committee print
title	title	string	Title of the committee print
updateDate	updateDate	date-time	The date the committee print was last updated
url	url	uri	URL to the full committee print

Committee Print: Get the text versions of a specified committee print

Operation ID:: CommitteePrintText

Get a list of text versions for a given committee print identified by congress, chamber, and jacket number.

Example Request:

https://api.congress.gov/v3/committee-print/117/house/48144/text?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The congress number. Example: 117
Congressional chamber	chamber	True	string	The chamber name. Accepted values: house, senate, nochamber
Jacket number	jacketNumber	True	integer	The unique jacket number assigned to the committee print. Example: 48144
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of text versions available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee print text versions
textVersionId	results.textVersionId	string	Unique identifier for the text version
updateDate	results.updateDate	date-time	The date the text version was last updated
format	results.format	string	The format of the text (e.g., PDF, XML)
url	results.url	uri	URL to the full text of the committee print

Committee Report: Get a list of committee reports

Operation ID:: CommitteeReports

Get a list of committee reports with optional filters for format, date range, and pagination.

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Filter by conference reports	conference	boolean	Filters results to include only conference reports if set to true.
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.
Filter by start date	fromDateTime	string	Filters reports updated after this timestamp. Format: YYYY-MM-DDT00:00:00Z.
Filter by end date	toDateTime	string	Filters reports updated before this timestamp. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type	Description
reports	reports	array of object	List of committee reports
chamber	reports.chamber	string	The congressional chamber (House or Senate)
citation	reports.citation	string	The citation reference for the committee report
congress	reports.congress	integer	The congress session number
number	reports.number	integer	The report number
part	reports.part	integer	The part number of the report
type	reports.type	string	The report type (e.g., HRPT for House Reports)
updateDate	reports.updateDate	date-time	The date the report was last updated
url	reports.url	uri	URL to the committee report

Committee Report: Get committee reports filtered by congress

Operation ID:: CommitteeReportsByCongress

Get a list of committee reports from a specified congress session with optional filters.

Example Request:

https://api.congress.gov/v3/committee-report/116?conference=true&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The session number of Congress. Example: 116
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Filter by conference reports	conference		boolean	Filters results to include only conference reports if set to true.
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.
Filter by start date	fromDateTime		string	Filters reports updated after this timestamp. Format: YYYY-MM-DDT00:00:00Z.
Filter by end date	toDateTime		string	Filters reports updated before this timestamp. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type	Description
reports	reports	array of object	List of committee reports
chamber	reports.chamber	string	The congressional chamber (House or Senate)
citation	reports.citation	string	The citation reference for the committee report
congress	reports.congress	integer	The congress session number
number	reports.number	integer	The report number
part	reports.part	integer	The part number of the report
type	reports.type	string	The report type (e.g., HRPT for House Reports)
updateDate	reports.updateDate	date-time	The date the report was last updated
url	reports.url	uri	URL to the committee report

Committee Report: Get committee reports for a given congress and report type

Operation ID:: CommitteeReportsByCongressRptType

Get a list of committee reports filtered by congress and report type.

Example Request:

https://api.congress.gov/v3/committee-report/116/hrpt?conference=true&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Committee report type	reportType	True	string	The type of committee report. Accepted values: hrpt (House Report), srpt (Senate Report), erpt (Executive Report)
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Conference report flag	conference		string	Indicates whether the report is a conference report. Accepted values: true, false
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.
Start date filter	fromDateTime		string	Filters reports starting from this date. Format: YYYY-MM-DDT00:00:00Z
End date filter	toDateTime		string	Filters reports up to this date. Format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of committee reports
chamber	results.chamber	string	The chamber of Congress (House or Senate)
citation	results.citation	string	The citation for the committee report
congress	results.congress	integer	The Congress session number
number	results.number	integer	The report number
part	results.part	integer	The part number of the report, if applicable
type	results.type	string	The type of report (HRPT, SRPT, ERPT)
updateDate	results.updateDate	date-time	The date the report was last updated
url	results.url	uri	URL to the committee report

Committee Report: Get detailed info for a specified committee report

Operation ID:: CommitteeReportDetails

Retrieves detailed info for a specific committee report by congress, report type, and report number.

Example Request:

https://api.congress.gov/v3/committee-report/116/HRPT/617?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Committee report type	reportType	True	string	The type of committee report. Accepted values: hrpt (House Report), srpt (Senate Report), erpt (Executive Report)
Committee report number	reportNumber	True	integer	The assigned number of the committee report. Example: 617
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
chamber	chamber	string	The chamber of Congress (House or Senate)
citation	citation	string	The citation for the committee report
congress	congress	integer	The Congress session number
number	number	integer	The report number
part	part	integer	The part number of the report, if applicable
type	type	string	The type of report (HRPT, SRPT, ERPT)
updateDate	updateDate	date-time	The date the report was last updated
url	url	uri	URL to the committee report

Committee Report: Get the full text of a specified committee report

Operation ID:: CommitteeReportIdText

Retrieves the full text of a committee report for a given congress session, report type, and report number.

Example Request:

https://api.congress.gov/v3/committee-report/116/hrpt/617/text?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Committee report type	reportType	True	string	The type of committee report. Accepted values: hrpt (House Report), srpt (Senate Report), erpt (Executive Report)
Committee report number	reportNumber	True	integer	The assigned number of the committee report. Example: 617
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
reportId	reportId	string	The unique identifier of the committee report
congress	congress	integer	The Congress session number
reportType	reportType	string	The type of report (HRPT, SRPT, ERPT)
reportNumber	reportNumber	integer	The report number
title	title	string	Title of the committee report
text	text	string	Full text content of the committee report
updateDate	updateDate	date-time	The date the report was last updated
url	url	uri	URL to the committee report

Committee: Get a list of committee reports for a congressional committee

Operation ID:: CommitteeReportsByCommittee

Example request: https://api.congress.gov/v3/committee/house/hspw00/reports?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber of Congress. Value can be 'house', 'senate', or 'joint'.
Committee Code	committeeCode	True	string	The unique system code for the committee. Example: hspw00.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. Default is 0.
Limit	limit		integer	The number of records returned. Max limit is 250.
From Date	fromDateTime		string	Starting timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.
To Date	toDateTime		string	Ending timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
reports	reports	array of object
reportNumber	reports.reportNumber	string
congress	reports.congress	integer
title	reports.title	string
dateIssued	reports.dateIssued	date
updateDate	reports.updateDate	date-time
url	reports.url	uri
count	count	integer

Committee: Get a list of congressional committees

Operation ID:: CommitteeList

Example request: https://api.congress.gov/v3/committee?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Data Format	format	string	Response format: xml or json.
Offset	offset	integer	The starting record returned. 0 is the first record.
Limit	limit	integer	The number of records returned. The maximum limit is 250.
From Date	fromDateTime	string	Start timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.
To Date	toDateTime	string	End timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
committees	committees	array of object
committeeId	committees.committeeId	string
name	committees.name	string
chamber	committees.chamber	string
type	committees.type	string
url	committees.url	uri

Committee: Get a list of congressional committees filtered by chamber

Operation ID:: CommitteeListByChamber

Example request: https://api.congress.gov/v3/committee/house?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber name. Value can be house, senate, or joint.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. 0 is the first record.
Limit	limit		integer	The number of records returned. The maximum limit is 250.
From Date	fromDateTime		string	Start timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.
To Date	toDateTime		string	End timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
committees	committees	array of object
committeeId	committees.committeeId	string
name	committees.name	string
chamber	committees.chamber	string
type	committees.type	string
url	committees.url	uri

Committee: Get a list of House communications for a congressional committee

Operation ID:: HouseCommunicationsByCommittee

Example request: https://api.congress.gov/v3/committee/house/hspw00/house-communication?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber of Congress. Value must be 'house'.
Committee Code	committeeCode	True	string	The committee's system code. Example: hspw00.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. Default is 0.
Limit	limit		integer	The number of records returned. Max limit is 250.

Returns

Name	Path	Type
communications	communications	array of object
communicationId	communications.communicationId	string
dateReceived	communications.dateReceived	date-time
subject	communications.subject	string
summary	communications.summary	string
updateDate	communications.updateDate	date-time
url	communications.url	uri
count	count	integer

Committee: Get a list of legislation associated with a congressional committee

Operation ID:: CommitteeBillsList

Example request: https://api.congress.gov/v3/committee/house/hspw00/bills?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber of Congress. Value can be 'house', 'senate', or 'joint'.
Committee Code	committeeCode	True	string	The unique system code for the committee. Example: hspw00.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. Default is 0.
Limit	limit		integer	The number of records returned. Max limit is 250.
From Date	fromDateTime		string	Starting timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.
To Date	toDateTime		string	Ending timestamp for update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
bills	bills	array of object
congress	bills.congress	integer
billType	bills.billType	string
billNumber	bills.billNumber	integer
title	bills.title	string
sponsor	bills.sponsor	string
introducedDate	bills.introducedDate	date
latestAction	bills.latestAction	string
updateDate	bills.updateDate	date-time
url	bills.url	uri
count	count	integer

Committee: Get a list of nominations for a specified congressional committee

Operation ID:: NominationByCommittee

Example request: https://api.congress.gov/v3/committee/senate/ssas00/nominations?format=json&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber of Congress. Value must be 'senate'.
Committee Code	committeeCode	True	string	The committee's system code. Example: ssas00.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. Default is 0.
Limit	limit		integer	The number of records returned. Max limit is 250.

Returns

Name	Path	Type
nominations	nominations	array of object
nominationId	nominations.nominationId	string
nomineeName	nominations.nomineeName	string
position	nominations.position	string
agency	nominations.agency	string
congress	nominations.congress	integer
updateDate	nominations.updateDate	date-time
url	nominations.url	uri
count	count	integer

Committee: Get a list of Senate communications for a congressional committee

Operation ID:: SenateCommunicationsByCommittee

Example request: https://api.congress.gov/v3/committee/senate/ssas00/senate-communication?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber of Congress. Value must be 'senate'.
Committee Code	committeeCode	True	string	The committee's system code. Example: ssas00.
Data Format	format		string	Response format: xml or json.
Offset	offset		integer	The starting record returned. Default is 0.
Limit	limit		integer	The number of records returned. Max limit is 250.

Returns

Name	Path	Type
communications	communications	array of object
communicationId	communications.communicationId	string
dateReceived	communications.dateReceived	date-time
subject	communications.subject	string
summary	communications.summary	string
updateDate	communications.updateDate	date-time
url	communications.url	uri
count	count	integer

Committee: Get detailed info for a specified congressional committee

Operation ID:: CommitteeDetailsByChamber

Example request: https://api.congress.gov/v3/committee/details/house/hspw00?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Chamber	chamber	True	string	The chamber name. Value can be house, senate, or joint.
Committee Code	committeeCode	True	string	The system code for the committee. Example: hspw00.
Data Format	format		string	Response format: xml or json.

Returns

Name	Path	Type
name	committee.name	string
systemCode	committee.systemCode	string
type	committee.type	string
chamber	committee.chamber	string
updateDate	committee.updateDate	date-time
subcommittees	committee.subcommittees	array of object
name	committee.subcommittees.name	string
systemCode	committee.subcommittees.systemCode	string

Congress: Get a list of congresses and congressional sessions

Operation ID:: CongressSessionList

https://api.congress.gov/v3/congress?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Data Format	format	string	Data format: xml or json
Offset	offset	integer	Starting record (0 is first record)
Limit	limit	integer	Number of records returned (max: 250)

Returns

Name	Path	Type
congresses	congresses	array of object
congress	congresses.congress	integer
startDate	congresses.startDate	date
endDate	congresses.endDate	date
sessions	congresses.sessions	array of object
session	congresses.sessions.session	integer
startDate	congresses.sessions.startDate	date
endDate	congresses.sessions.endDate	date
updateDate	congresses.updateDate	date-time

Congress: Get detailed info for a specified congress

Operation ID:: CongressDetails

https://api.congress.gov/v3/congress/116?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. Example: 117
Data Format	format		string	Data format: xml or json

Returns

Name	Path	Type
congress	congress	integer
startDate	startDate	date
endDate	endDate	date
sessions	sessions	array of object
session	sessions.session	integer
startDate	sessions.startDate	date
endDate	sessions.endDate	date
updateDate	updateDate	date-time

Congress: Get detailed info for the current congress

Operation ID:: CongressCurrentList

https://api.congress.gov/v3/congress/current?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
See description	format	string	The data format. Value can be xml or json
See description	offset	integer	The starting record returned. 0 is the first record
See description	limit	integer	The number of records returned. The maximum limit is 250

Congressional Record: Get a list of congressional record issues

Operation ID:: CongressionalRecordList

Get a list of Congressional Record issues sorted by most recent. Example: https://api.congress.gov/v3/congressional-record/?y=2022&m=6&d=28&api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response Format	format	string	The format of the response. Allowed values: xml, json.
Publication Year	y	integer	The year the congressional record was published. Example: 2022.
Publication Month	m	integer	The month the congressional record was published (1-12). Example: 6 for June.
Publication Day	d	integer	The day the congressional record was published (1-31). Example: 28.
Record Offset	offset	integer	The starting index for paginated results. Default is 0.
Number of Records	limit	integer	The maximum number of records to return. The maximum limit is 250.

Returns

Name	Path	Type
congressionalRecords	congressionalRecords	array of object
date	congressionalRecords.date	date
volume	congressionalRecords.volume	integer
issue	congressionalRecords.issue	string
updateDate	congressionalRecords.updateDate	date-time
url	congressionalRecords.url	string

CRS Report: Get CRS Reports

Operation ID:: CRSReportList

Retrieve a list of CRS reports available in Congress.gov, sorted by the most recent updates

Parameters

Name	Key	Type	Description
Response Format	format	string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset	integer	The starting record returned. Default is 0 (first record).
Record Limit	limit	integer	The number of records returned. Maximum limit is 250.
Filter Start Date	fromDateTime	string	Starting timestamp for filtering CRS reports by update date. Format: YYYY-MM-DDT00:00:00Z.
Filter End Date	toDateTime	string	Ending timestamp for filtering CRS reports by update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
CRSReports	CRSReports	array of object
contentType	CRSReports.contentType	string
id	CRSReports.id	string
publishDate	CRSReports.publishDate	date-time
status	CRSReports.status	string
title	CRSReports.title	string
updateDate	CRSReports.updateDate	date-time
url	CRSReports.url	string
version	CRSReports.version	integer

CRS Report: Get details for a specific CRS report

Operation ID:: CRSReportDetails

Retrieve detailed metadata for a specific CRS report using its report ID

Parameters

Name	Key	Required	Type	Description
CRS Report ID	reportId	True	string	The unique identifier for the CRS report (e.g., R47175).
Response Format	format		string	The format of the response. Allowed values: xml, json.

Returns

Name	Path	Type
authors	CRSReport.authors	array of object
author	CRSReport.authors.author	string
contentType	CRSReport.contentType	string
formats	CRSReport.formats	array of object
format	CRSReport.formats.format	string
url	CRSReport.formats.url	string
id	CRSReport.id	string
publishDate	CRSReport.publishDate	date-time
relatedMaterials	CRSReport.relatedMaterials	array of object
URL	CRSReport.relatedMaterials.URL	string
congress	CRSReport.relatedMaterials.congress	integer
number	CRSReport.relatedMaterials.number	string
title	CRSReport.relatedMaterials.title	array of string
type	CRSReport.relatedMaterials.type	string
status	CRSReport.status	string
summary	CRSReport.summary	string
title	CRSReport.title	string
topics	CRSReport.topics	array of object
topic	CRSReport.topics.topic	string
updateDate	CRSReport.updateDate	date-time
url	CRSReport.url	string
version	CRSReport.version	integer

Daily Congressional Record: Get a list of daily issues by volume number

Operation ID:: DailyCongressionalRecordListByVolume

Get a list of daily congressional record issues filtered by the specified volume number. Example: https://api.congress.gov/v3/daily-congressional-record/166?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Volume number	volumeNumber	True	integer	The specified volume of the daily Congressional record. Example: 166
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of daily congressional record issues
issueDate	results.issueDate	date	The date of the congressional record issue
volume	results.volume	integer	The volume number of the congressional record
issue	results.issue	integer	The issue number of the congressional record
url	results.url	uri	URL to the congressional record issue

Daily Congressional Record: Get a list of daily record issues

Operation ID:: DailyCongressionalRecordList

Get a list of daily congressional record issues sorted by date.

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of daily congressional record issues
issueDate	results.issueDate	date	The date of the congressional record issue
volume	results.volume	integer	The volume number of the congressional record
issue	results.issue	integer	The issue number of the congressional record
url	results.url	uri	URL to the congressional record issue

Daily Congressional Record: Get daily articles by volume and issue

Operation ID:: DailyCongressionalRecordListByArticle

Get a list of articles from the daily congressional record based on the specified volume and issue number. Example: https://api.congress.gov/v3/daily-congressional-record/167/21/articles?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Volume number	volumeNumber	True	integer	The specified volume of the daily Congressional record. Example: 167
Issue number	issueNumber	True	integer	The specified issue number within the volume. Example: 21
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of daily congressional record articles
articleId	results.articleId	string	Unique identifier for the article
title	results.title	string	Title of the article
chamber	results.chamber	string	The chamber where the article originated. Example: House, Senate
datePublished	results.datePublished	date	The date the article was published
url	results.url	uri	URL to the article

Daily Congressional Record: Get daily issues by volume and issue number

Operation ID:: DailyCongressionalRecordListByVolumeAndIssue

Get a list of daily congressional record issues filtered by the specified volume and issue number. Example: https://api.congress.gov/v3/daily-congressional-record/166/92?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Volume number	volumeNumber	True	integer	The specified volume of the daily Congressional record. Example: 166
Issue number	issueNumber	True	integer	The specified issue number within the volume. Example: 92
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of records available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of daily congressional record issues
issueDate	results.issueDate	date	The date of the congressional record issue
volume	results.volume	integer	The volume number of the congressional record
issue	results.issue	integer	The issue number of the congressional record
url	results.url	uri	URL to the congressional record issue

Hearing: Get a list of congressional hearings

Operation ID:: HearingList

Get a list of congressional hearings, including metadata such as dates, committees, and hearing titles. Example: https://api.congress.gov/v3/hearing?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit	integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of hearings available
offset	offset	integer	Current offset of results
limit	limit	integer	Limit of results per request
hearings	hearings	array of object	List of congressional hearings
hearingId	hearings.hearingId	string	Unique identifier for the hearing
title	hearings.title	string	Title of the hearing
date	hearings.date	date-time	Date and time of the hearing
committee	hearings.committee	string	Name of the committee overseeing the hearing
chamber	hearings.chamber	string	Chamber of Congress (House or Senate)
url	hearings.url	uri	API URL for additional hearing details

Hearing: Get a list of hearings filtered by congress

Operation ID:: HearingListByCongress

Get a list of congressional hearings for a specific Congress session. Example: https://api.congress.gov/v3/hearing/116?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of hearings available
offset	offset	integer	Current offset of results
limit	limit	integer	Limit of results per request
hearings	hearings	array of object	List of congressional hearings
hearingId	hearings.hearingId	string	Unique identifier for the hearing
title	hearings.title	string	Title of the hearing
date	hearings.date	date-time	Date and time of the hearing
committee	hearings.committee	string	Name of the committee overseeing the hearing
chamber	hearings.chamber	string	Chamber of Congress (House or Senate)
url	hearings.url	uri	API URL for additional hearing details

Hearing: Get a list of hearings filtered by congress and chamber

Operation ID:: HearingListByCongressChamber

Get a list of congressional hearings for a specific Congress session and chamber. Example: https://api.congress.gov/v3/hearing/116/house?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Congress chamber	chamber	True	string	The chamber name. Accepted values: house, senate, or nochamber
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of hearings available
offset	offset	integer	Current offset of results
limit	limit	integer	Limit of results per request
hearings	hearings	array of object	List of congressional hearings
hearingId	hearings.hearingId	string	Unique identifier for the hearing
title	hearings.title	string	Title of the hearing
date	hearings.date	date-time	Date and time of the hearing
committee	hearings.committee	string	Name of the committee overseeing the hearing
chamber	hearings.chamber	string	Chamber of Congress (House or Senate)
url	hearings.url	uri	API URL for additional hearing details

Hearing: Get detailed info for a specified hearing

Operation ID:: HearingDetail

Retrieves detailed hearing information for a specific Congress session, chamber, and jacket number. Example: https://api.congress.gov/v3/hearing/116/house/41365?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Congress chamber	chamber	True	string	The chamber name. Accepted values: house, senate, or nochamber
Hearing jacket number	jacketNumber	True	integer	The jacket number assigned to the hearing. Example: 41365
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
hearingId	hearingId	string	Unique identifier for the hearing
title	title	string	Title of the hearing
date	date	date-time	Date and time of the hearing
chamber	chamber	string	Chamber of Congress (House, Senate, or NoChamber)
name	committee.name	string	Name of the committee overseeing the hearing
code	committee.code	string	Committee code
url	committee.url	uri	API URL for committee details
witnesses	witnesses	array of object	List of witnesses who testified
name	witnesses.name	string	Full name of the witness
organization	witnesses.organization	string	Affiliation or organization represented by the witness
position	witnesses.position	string	Title or role of the witness
documents	documents	array of object	List of documents related to the hearing
title	documents.title	string	Title of the document
url	documents.url	uri	API URL for the document
url	url	uri	API URL for more details about the hearing

House Communication: Get detailed info for a specified House communication

Operation ID:: HouseCommunicationDetail

Retrieves detailed info for a specific House communication identified by Congress session, communication type, and communication number.

Example Request:

https://api.congress.gov/v3/house-communication/117/ec/3324?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Communication type	communicationType	True	string	The type of House communication. Accepted values: `ec`, `ml`, `pm`, or `pt`
Communication number	communicationNumber	True	integer	The assigned number of the House communication. Example: `3324`
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
communicationId	communicationId	string	Unique identifier for the House communication
congress	congress	integer	Congress session associated with the communication
communicationType	communicationType	string	Type of House communication (e.g., `ec`, `ml`, `pm`, `pt`)
communicationNumber	communicationNumber	integer	The assigned number of the House communication
date	date	date	Date the communication was recorded
chamber	chamber	string	The chamber associated with the communication (House)
summary	summary	string	Summary of the House communication
textUrl	textUrl	uri	URL to the full text of the communication

House Communication: Get House communications by Congress session and comm type

Operation ID:: HouseCommunicationListCommunicationType

Retrieves a list of House communications filtered by Congress session and communication type.

Example Request:

https://api.congress.gov/v3/house-communication/117/ec?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Communication type	communicationType	True	string	The type of House communication. Accepted values: `ec`, `ml`, `pm`, or `pt`
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of House communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of House communications
communicationId	results.communicationId	string	Unique identifier for the House communication
date	results.date	date	Date the communication was recorded
chamber	results.chamber	string	The chamber associated with the communication (House)
communicationType	results.communicationType	string	The type of communication (e.g., `ec`, `ml`, `pm`, `pt`)
description	results.description	string	Brief description of the House communication
url	results.url	uri	URL to the full House communication details

House Communication: Get House communications for a specified Congress session

Operation ID:: HouseCommunicationCongress

Retrieves a list of House communications recorded in a specific Congress session.

Example Request:

https://api.congress.gov/v3/house-communication/117?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of House communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of House communications
communicationId	results.communicationId	string	Unique identifier for the House communication
date	results.date	date	Date the communication was recorded
chamber	results.chamber	string	The chamber associated with the communication (House)
description	results.description	string	Brief description of the House communication
url	results.url	uri	URL to the full House communication details

House Communication: Retrieves a list of House communications

Operation ID:: HouseCommunicationsList

Retrieves a list of House communications recorded in the Congressional system.

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values are `xml` or `json`.
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of House communications available.
offset	offset	integer	Offset of the first returned record.
limit	limit	integer	Maximum number of records per response.
results	results	array of object	Array of House communications.
chamber	results.chamber	string	The chamber of the communication (e.g., House).
communicationNumber	results.communicationNumber	integer	The unique number assigned to the communication.
code	results.communicationType.code	string	Short code of the communication type (e.g., EC).
name	results.communicationType.name	string	Full name of the communication type (e.g., Executive Communication).
congressNumber	results.congressNumber	integer	The Congress session number.
url	results.url	uri	URL to retrieve the communication details.

House Requirement: Get a list of House requirements

Operation ID:: HouseRequirement

Retrieves a list of House requirements as defined by Congress.

Example Request:

https://api.congress.gov/v3/house-requirement?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of House requirements available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of House requirements
requirementId	results.requirementId	string	Unique identifier for the House requirement
title	results.title	string	Title of the House requirement
description	results.description	string	Detailed description of the House requirement
effectiveDate	results.effectiveDate	date	Date when the requirement became effective
status	results.status	string	Current status of the requirement (e.g., Active, Inactive)
url	results.url	uri	URL to the full text of the requirement

House Requirement: Get detailed info for a specific House requirement

Operation ID:: HouseRequirementDetail

Retrieves detailed info about a specific House requirement by its assigned number.

Example Request:

https://api.congress.gov/v3/house-requirement/8070?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Requirement Number	requirementNumber	True	integer	The unique number assigned to the House requirement. Example: 8070
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
requirementId	requirementId	string	Unique identifier for the House requirement
title	title	string	Title of the House requirement
description	description	string	Detailed description of the House requirement
effectiveDate	effectiveDate	date	Date when the requirement became effective
status	status	string	Current status of the requirement (e.g., Active, Inactive)
url	url	uri	URL to the full text of the requirement

House Requirement: Get matching comms for a specific House requirement

Operation ID:: HouseRequirementCommunicationList

Retrieves a list of communications that match a specified House requirement.

Example Request:

https://api.congress.gov/v3/house-requirement/8070/matching-communications?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Requirement Number	requirementNumber	True	integer	The unique number assigned to the House requirement. Example: 8070
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of matching communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of matching communications
communicationId	results.communicationId	string	Unique identifier for the communication
dateReceived	results.dateReceived	date	Date when the communication was received
subject	results.subject	string	Subject or title of the communication
agency	results.agency	string	Agency or department associated with the communication
url	results.url	uri	URL to the full communication details

Laws: Get a law filtered by specified congress, law type, and law number

Operation ID:: LawListByCongressLawTypeAndLawNumber

https://api.congress.gov/v3/law/117/pub/108?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. Example: 117
Law Type	lawType	True	string	The law type. Allowed values: 'pub' (public law) or 'priv' (private law).
Law Number	lawNumber	True	integer	The assigned law number. Example: 108
Format	format		string	Data format: xml or json
Offset	offset		integer	Starting record (0 is first record)
Limit	limit		integer	Number of records (max: 250)

Returns

Name	Path	Type
congress	congress	integer
lawNumber	lawNumber	string
lawType	lawType	string
title	title	string
updateDate	updateDate	date-time
url	url	uri

Laws: Get a list of laws filtered by congress

Operation ID:: LawListByCongress

https://api.congress.gov/v3/law/118?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. Example: 118
Format	format		string	Data format: xml or json
Offset	offset		integer	Starting record (0 is first record)
Limit	limit		integer	Number of records (max: 250)

Returns

Name	Path	Type
laws	laws	array of object
congress	laws.congress	integer
lawNumber	laws.lawNumber	string
title	laws.title	string
updateDate	laws.updateDate	date-time
url	laws.url	uri

Laws: Get a list of laws filtered by congress and law type

Operation ID:: LawListByCongressAndLawType

https://api.congress.gov/v3/law/118/pub?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. Example: 118
Law Type	lawType	True	string	The law type. Allowed values: 'pub' (public law) or 'priv' (private law).
Format	format		string	Data format: xml or json
Offset	offset		integer	Starting record (0 is first record)
Limit	limit		integer	Number of records (max: 250)

Returns

Name	Path	Type
laws	laws	array of object
congress	laws.congress	integer
lawNumber	laws.lawNumber	string
lawType	laws.lawType	string
title	laws.title	string
updateDate	laws.updateDate	date-time
url	laws.url	uri

Member: Get a list of congressional members

Operation ID:: MemberList

https://api.congress.gov/v3/member?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Data Format	format	string	The data format: xml or json
Offset	offset	integer	Starting record (0 is first)
Record Limit	limit	integer	Number of records returned (max 250)
Start Date	fromDateTime	string	Filter members updated from this date (YYYY-MM-DDT00:00:00Z)
End Date	toDateTime	string	Filter members updated up to this date (YYYY-MM-DDT00:00:00Z)
Current Member	currentMember	boolean	Filter by current members only: true or false

Returns

Name	Path	Type
members	members	array of object
bioguideId	members.bioguideId	string
firstName	members.firstName	string
lastName	members.lastName	string
fullName	members.fullName	string
party	members.party	string
state	members.state	string
chamber	members.chamber	string
congress	members.congress	integer
url	members.url	uri
updateDate	members.updateDate	date-time

Member: Get a list of legislation cosponsored by a congressional member

Operation ID:: CosponsorshipList

https://api.congress.gov/v3/member/L000174/cosponsored-legislation?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Bioguide ID	bioguideId	True	string	Unique identifier for the congressional member (e.g., L000174)
Data Format	format		string	Response format: xml or json
Offset	offset		integer	The starting record returned. Default: 0
Limit	limit		integer	The number of records returned (max: 250)

Returns

Name	Path	Type
cosponsoredLegislation	cosponsoredLegislation	array of object
congress	cosponsoredLegislation.congress	integer
billType	cosponsoredLegislation.billType	string
billNumber	cosponsoredLegislation.billNumber	integer
title	cosponsoredLegislation.title	string
updateDate	cosponsoredLegislation.updateDate	date-time
url	cosponsoredLegislation.url	uri

Member: Get a list of legislation sponsored by a congressional member

Operation ID:: SponsorshipList

https://api.congress.gov/v3/member/L000174/sponsored-legislation?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Bioguide ID	bioguideId	True	string	Unique identifier for the congressional member (e.g., L000174)
Data Format	format		string	Response format: xml or json
Offset	offset		integer	The starting record returned. Default: 0
Limit	limit		integer	The number of records returned (max: 250)

Returns

Name	Path	Type
sponsoredLegislation	sponsoredLegislation	array of object
congress	sponsoredLegislation.congress	integer
billType	sponsoredLegislation.billType	string
billNumber	sponsoredLegislation.billNumber	integer
title	sponsoredLegislation.title	string
updateDate	sponsoredLegislation.updateDate	date-time
url	sponsoredLegislation.url	uri

Member: Get a list of members filtered by congress, state and district

Operation ID:: MemberListByCongressStateDistrict

https://api.congress.gov/v3/member/congress/97/TX/10?currentMember=False&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
See description	congress	True	integer	The Congress number. For example, 118
See description	stateCode	True	string	The two letter identifier for the state the member represents. For example, the value can be MI for Michigan
See description	district	True	integer	The district number for the district the member represents. For example, the value can be 10
See description	format		string	The data format. Value can be xml or json
See description	currentMember		string	The status of the member. Use true or false. Use currentMember=True for the current congress data only

Member: Get a list of members filtered by state and district

Operation ID:: MemberListByStateAndDistrict

Example request: https://api.congress.gov/v3/member/MI/10?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
State Code	stateCode	True	string	Two-letter state code representing the state the member represents. Example: MI (Michigan).
District Number	district	True	integer	The congressional district number of the member. Example: 10.
Data Format	format		string	Response format: xml or json.
Current Member	currentMember		boolean	Filters results by active members only (true/false). Use `true` for current Congress data only.

Returns

Name	Path	Type
members	members	array of object
bioguideId	members.bioguideId	string
fullName	members.fullName	string
party	members.party	string
state	members.state	string
district	members.district	integer
chamber	members.chamber	string
startDate	members.startDate	date-time
endDate	members.endDate	date-time
url	members.url	uri

Member: Get detailed info for a specified congressional member

Operation ID:: MemberDetails

https://api.congress.gov/v3/member/L000174?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Bioguide ID	bioguideId	True	string	Unique identifier for the congressional member (e.g., L000174)
Data Format	format		string	Response format: xml or json

Returns

Name	Path	Type
bioguideId	bioguideId	string
firstName	firstName	string
lastName	lastName	string
fullName	fullName	string
party	party	string
state	state	string
chamber	chamber	string
congress	congress	integer
url	url	uri
updateDate	updateDate	date-time

Member: Get the list of members specified by Congress

Operation ID:: CongressList

Example request: https://api.congress.gov/v3/member/congress/118?api_key=[INSERT_KEY] Previous Congress: https://api.congress.gov/v3/member/congress/117?currentMember=False&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number for the member list. Example: 118
Data Format	format		string	Response format: xml or json
Offset	offset		integer	Starting record index. Default: 0
Limit	limit		integer	Number of records returned (max: 250)
Current Member	currentMember		boolean	Filters current members only (true/false). Use `false` for past Congresses.

Returns

Name	Path	Type
members	members	array of object
bioguideId	members.bioguideId	string
fullName	members.fullName	string
party	members.party	string
state	members.state	string
chamber	members.chamber	string
startDate	members.startDate	date-time
endDate	members.endDate	date-time
url	members.url	uri

Nomination: Get actions on a specified nomination

Operation ID:: NominationActions

Retrieves all recorded actions taken on a specific nomination, such as committee referrals, hearings, and votes. Example: https://api.congress.gov/v3/nomination/117/2467/actions?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congressional session number. Example: 117
Nomination Number	nominationNumber	True	integer	The assigned nomination number. Example: 2467
Response Format	format		string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset		integer	The starting record returned. Default is 0 (first record).
Record Limit	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type
nominationNumber	nominationNumber	string
congress	congress	integer
actions	actions	array of object
actionDate	actions.actionDate	date-time
description	actions.description	string
committee	actions.committee	string
updateDate	actions.updateDate	date-time
updateDate	updateDate	date-time

Nomination: Get committees associated with a specified nomination

Operation ID:: NominationCommittees

Retrieves all congressional committees assigned to evaluate or process a specific nomination. Example: https://api.congress.gov/v3/nomination/117/2467/committees?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congressional session number. Example: 117
Nomination Number	nominationNumber	True	integer	The assigned nomination number. Example: 2467
Response Format	format		string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset		integer	The starting record returned. Default is 0 (first record).
Record Limit	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type
nominationNumber	nominationNumber	string
congress	congress	integer
committees	committees	array of object
committeeName	committees.committeeName	string
committeeCode	committees.committeeCode	string
chamber	committees.chamber	string
updateDate	committees.updateDate	date-time
updateDate	updateDate	date-time

Nomination: Get detailed info for a specified nomination

Operation ID:: NominationDetail

Retrieves details for a specific nomination, including nominee name, position, agency, and status. Example: https://api.congress.gov/v3/nomination/117/2467?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congressional session number. Example: 117
Nomination Number	nominationNumber	True	integer	The assigned nomination number. Example: 2467
Response Format	format		string	The format of the response. Allowed values: xml, json.

Returns

Name	Path	Type
nominationNumber	nominationNumber	string
congress	congress	integer
nominees	nominees	array of object
name	nominees.name	string
position	nominees.position	string
agency	nominees.agency	string
state	nominees.state	string
status	nominees.status	string
updateDate	nominees.updateDate	date-time
updateDate	updateDate	date-time

Nomination: Get nominations

Operation ID:: NominationList

https://api.congress.gov/v3/nomination?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
See description	format	string	The data format. Value can be xml or json
See description	offset	integer	The starting record returned. 0 is the first record
See description	limit	integer	The number of records returned. The maximum limit is 250
See description	fromDateTime	string	Starting timestampe for update date. Use YYYY-MM-DDT00:00:00Z
See description	toDateTime	string	The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
nominations	nominations	array of object
citation	nominations.citation	string
congress	nominations.congress	integer
actionDate	nominations.latestAction.actionDate	date
text	nominations.latestAction.text	string
isMilitary	nominations.nominationType.isMilitary	boolean
number	nominations.number	integer
organization	nominations.organization	string
partNumber	nominations.partNumber	string
receivedDate	nominations.receivedDate	date
updateDate	nominations.updateDate	date-time
url	nominations.url	uri

Nomination: Get nominations by congress and date from the President

Operation ID:: NominationListByCongress

Get a list of nominations submitted by the President for a specific Congress, filtered by date. Example: https://api.congress.gov/v3/nomination/117?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congressional session number. Example: 117
Response Format	format		string	The format of the response. Allowed values: xml, json.
Record Offset	offset		integer	The starting index for paginated results. Default is 0.
Number of Records	limit		integer	The maximum number of records to return. The maximum limit is 250.
Starting Date Filter	fromDateTime		string	Filters nominations from this date forward. Format: YYYY-MM-DDT00:00:00Z
Ending Date Filter	toDateTime		string	Filters nominations up to this date. Format: YYYY-MM-DDT00:00:00Z

Returns

Name	Path	Type
nominations	nominations	array of object
nominationNumber	nominations.nominationNumber	string
congress	nominations.congress	integer
receivedDate	nominations.receivedDate	date
description	nominations.description	string
updateDate	nominations.updateDate	date-time
url	nominations.url	string

Nomination: Get printed hearings associated with a nomination

Operation ID:: NominationHearings

Retrieves all printed hearings related to a specific nomination. Example: https://api.congress.gov/v3/nomination/116/389/hearings?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congressional session number. Example: 116
Nomination Number	nominationNumber	True	integer	The assigned nomination number. Example: 389
Response Format	format		string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset		integer	The starting record returned. Default is 0 (first record).
Record Limit	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type
nominationNumber	nominationNumber	integer
congress	congress	integer
hearings	hearings	array of object
hearingTitle	hearings.hearingTitle	string
committeeName	hearings.committeeName	string
hearingDate	hearings.hearingDate	date-time
updateDate	hearings.updateDate	date-time
updateDate	updateDate	date-time

Retrieve a list of Senate communications

Operation ID:: SenateCommunication

Retrieves a list of Senate communications.

Example Request:

https://api.congress.gov/v3/senate-communication?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response format	format	string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset	integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit	integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of Senate communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of Senate communications
communicationId	results.communicationId	string	Unique identifier for the communication
dateReceived	results.dateReceived	date	Date when the communication was received
subject	results.subject	string	Subject or title of the communication
agency	results.agency	string	Agency or department associated with the communication
url	results.url	uri	URL to the full communication details

Senate Communication: Get details for a specified Senate communication

Operation ID:: SenateCommunicationDetail

Retrieves detailed information for a Senate communication filtered by Congress session, communication type, and assigned number.

Example Request:

https://api.congress.gov/v3/senate-communication/117/ec/2561?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Type of Senate communication	communicationType	True	string	The type of Senate communication. Accepted values: ec, pm, pom
Assigned communication number	communicationNumber	True	integer	The unique number assigned to the Senate communication. Example: 2561
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
communicationId	communicationId	string	Unique identifier for the communication
dateReceived	dateReceived	date	Date when the communication was received
subject	subject	string	Subject or title of the communication
agency	agency	string	Agency or department associated with the communication
relatedBills	relatedBills	array of object	List of related bills
billNumber	relatedBills.billNumber	string	Bill number related to the communication
title	relatedBills.title	string	Title of the related bill
url	relatedBills.url	uri	URL to the bill details
url	url	uri	URL to the full communication details

Senate Communication: Get Senate comms by Congress session and type

Operation ID:: SenateCommunicationList

Retrieves a list of Senate communications filtered by Congress session and communication type.

Example Request:

https://api.congress.gov/v3/senate-communication/117/ec?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Type of Senate communication	communicationType	True	string	The type of Senate communication. Accepted values: ec, pm, pom
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of Senate communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of Senate communications
communicationId	results.communicationId	string	Unique identifier for the communication
dateReceived	results.dateReceived	date	Date when the communication was received
subject	results.subject	string	Subject or title of the communication
agency	results.agency	string	Agency or department associated with the communication
url	results.url	uri	URL to the full communication details

Senate Communication: Get Senate comms for a specified Congress session

Operation ID:: SenateCommunicationCongress

Retrieves a list of Senate communications filtered by Congress session.

Example Request:

https://api.congress.gov/v3/senate-communication/117?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	Specifies the starting record returned. Default is 0.
Maximum number of records	limit		integer	Specifies the number of records returned. The maximum limit is 250.

Returns

Name	Path	Type	Description
count	count	integer	Total number of Senate communications available
offset	offset	integer	Offset of the first returned record
limit	limit	integer	Maximum number of records per response
results	results	array of object	Array of Senate communications
communicationId	results.communicationId	string	Unique identifier for the communication
dateReceived	results.dateReceived	date	Date when the communication was received
subject	results.subject	string	Subject or title of the communication
agency	results.agency	string	Agency or department associated with the communication
url	results.url	uri	URL to the full communication details

Summaries: Get summaries by congress and bill type

Operation ID:: BillSummariesByType

https://api.congress.gov/v3/summaries/117/hr?fromDateTime=2022-04-01T00:00:00Z&toDateTime=2022-04-03T00:00:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. For example, 117
Bill Type	billType	True	string	Type of bill: hr, s, hjres, sjres, hconres, sconres, hres, or sres
Format	format		string	Data format: xml or json
Offset	offset		integer	Starting record (0 is first record)
Limit	limit		integer	Number of records (max: 250)
Start DateTime	fromDateTime		string	Start timestamp (YYYY-MM-DDT00:00:00Z)
End DateTime	toDateTime		string	End timestamp (YYYY-MM-DDT00:00:00Z)
Sort Order	sort		string	Sort by update date: updateDate+asc or updateDate+desc

Returns

Name	Path	Type
summaries	summaries	array of object
congress	summaries.congress	integer
billNumber	summaries.billNumber	integer
billType	summaries.billType	string
summaryText	summaries.summaryText	string
updateDate	summaries.updateDate	date-time
url	summaries.url	uri

Summaries: Get summaries filtered by congress

Operation ID:: BillSummariesByCongress

https://api.congress.gov/v3/summaries/117?fromDateTime=2022-04-01T00:00:00Z&toDateTime=2022-04-03T00:00:00Z&sort=updateDate+desc&api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. For example, the value can be 117
Format	format		string	The data format. Value can be xml or json
Offset	offset		integer	Starting record number (0 is first record)
Limit	limit		integer	Number of records returned (max: 250)
Start DateTime	fromDateTime		string	Start timestamp for update date (YYYY-MM-DDT00:00:00Z)
End DateTime	toDateTime		string	End timestamp for update date (YYYY-MM-DDT00:00:00Z)
Sort Order	sort		string	Sort order for update date. Values: updateDate+asc or updateDate+desc

Returns

Name	Path	Type
summaries	summaries	array of object
congress	summaries.congress	integer
billNumber	summaries.billNumber	integer
billType	summaries.billType	string
summaryText	summaries.summaryText	string
updateDate	summaries.updateDate	date-time
url	summaries.url	uri

Treaty: Get actions on a specified treaty

Operation ID:: TreatyAction

Retrieves the actions taken on a treaty for a given congress session and treaty number. Example: https://api.congress.gov/v3/treaty/117/3/actions?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Treaty number	treatyNumber	True	integer	The assigned number of the treaty. Example: 3
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
congress	congress	integer	The Congress session number
treatyNumber	treatyNumber	integer	The assigned number of the treaty
actions	actions	array of object	List of actions taken on the treaty
actionDate	actions.actionDate	date-time	Date the action was taken
actionType	actions.actionType	string	Type of action taken on the treaty
description	actions.description	string	Detailed description of the action taken

Treaty: Get committees associated with a specified treaty

Operation ID:: TreatyCommittee

Retrieves the committees that are reviewing or have reviewed a specified treaty in a given Congress session. Example: https://api.congress.gov/v3/treaty/116/3/committees?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 116
Treaty number	treatyNumber	True	integer	The assigned number of the treaty. Example: 3
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
congress	congress	integer	The Congress session number
treatyNumber	treatyNumber	integer	The assigned number of the treaty
committees	committees	array of object	List of committees reviewing the treaty
committeeName	committees.committeeName	string	Official name of the committee
committeeCode	committees.committeeCode	string	Unique committee code identifier
chamber	committees.chamber	string	Chamber of Congress (House or Senate)
url	committees.url	uri	API URL for additional committee details

Treaty: Get detailed info for a specified partitioned treaty

Operation ID:: TreatyDetails

Retrieves detailed treaty information for a given congress session, treaty number, and partition letter. Example: https://api.congress.gov/v3/treaty/114/13/A?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 114
Treaty number	treatyNumber	True	integer	The assigned number of the treaty. Example: 13
Partition letter	treatySuffix	True	string	The partition letter for the treaty. Example: A
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
treatyNumber	treatyNumber	integer	The assigned number of the treaty
congress	congress	integer	The Congress session in which the treaty was introduced
treatySuffix	treatySuffix	string	The partition letter of the treaty
title	title	string	The title of the treaty
dateReceived	dateReceived	date-time	The date the treaty was received by the Senate
dateUpdated	dateUpdated	date-time	The date the treaty information was last updated
status	status	string	Current status of the treaty
actions	actions	array of object	List of actions related to the treaty
date	actions.date	date-time	Date of the action
description	actions.description	string	Description of the action taken
committees	committees	array of object	List of committees associated with the treaty
name	committees.name	string	Name of the committee
code	committees.code	string	Committee code

Treaty: Get detailed info for a specified treaty

Operation ID:: TreatyDetail

Retrieves detailed treaty information for a given congress session and treaty number. Example: https://api.congress.gov/v3/treaty/117/3?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 117
Treaty number	treatyNumber	True	integer	The assigned number of the treaty. Example: 3
Response format	format		string	Specifies the format of the response. Accepted values: xml, json

Returns

Name	Path	Type	Description
treatyNumber	treatyNumber	integer	The assigned number of the treaty
congress	congress	integer	The Congress session in which the treaty was introduced
title	title	string	The title of the treaty
dateReceived	dateReceived	date-time	The date the treaty was received by the Senate
dateUpdated	dateUpdated	date-time	The date the treaty information was last updated
status	status	string	Current status of the treaty
actions	actions	array of object	List of actions related to the treaty
date	actions.date	date-time	Date of the action
description	actions.description	string	Description of the action taken
committees	committees	array of object	List of committees associated with the treaty
name	committees.name	string	Name of the committee
code	committees.code	string	Committee code

Treaty: Get the list of actions on a specified partitioned treaty

Operation ID:: TreatyActions

Retrieves the actions taken on a partitioned treaty for a given congress session, treaty number, and suffix. Example: https://api.congress.gov/v3/treaty/114/13/A/actions?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress session number	congress	True	integer	The number representing the Congress session. Example: 114
Treaty number	treatyNumber	True	integer	The assigned number of the treaty. Example: 13
Partition suffix	treatySuffix	True	string	The treaty's partition letter value. Example: A
Response format	format		string	Specifies the format of the response. Accepted values: xml, json
Starting record offset	offset		integer	The starting record returned. Default is 0 (first record).
Number of records to return	limit		integer	The number of records returned. Maximum limit is 250.

Returns

Name	Path	Type	Description
congress	congress	integer	The Congress session number
treatyNumber	treatyNumber	integer	The assigned number of the treaty
treatySuffix	treatySuffix	string	The partition suffix of the treaty
actions	actions	array of object	List of actions taken on the partitioned treaty
actionDate	actions.actionDate	date-time	Date the action was taken
actionType	actions.actionType	string	Type of action taken on the treaty
description	actions.description	string	Detailed description of the action taken

Treaty: Get treaties

Operation ID:: TreatyList

Get a list of treaties available in Congress.gov, sorted by the most recent updates. Example: https://api.congress.gov/v3/treaty?api_key=[INSERT_KEY]

Parameters

Name	Key	Type	Description
Response Format	format	string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset	integer	The starting record returned. Default is 0 (first record).
Record Limit	limit	integer	The number of records returned. Maximum limit is 250.
Filter Start Date	fromDateTime	string	Starting timestamp for filtering treaties by update date. Format: YYYY-MM-DDT00:00:00Z.
Filter End Date	toDateTime	string	Ending timestamp for filtering treaties by update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
treaties	treaties	array of object
treatyTitle	treaties.treatyTitle	string
treatyNumber	treaties.treatyNumber	string
congress	treaties.congress	integer
updateDate	treaties.updateDate	date-time
updateDate	updateDate	date-time

Treaty: Get treaties for the specified congress

Operation ID:: TreatyListByCongress

Retrieves treaties associated with a specific congress, sorted by the most recent updates. Example request: https://api.congress.gov/v3/treaty/117?api_key=[INSERT_KEY]

Parameters

Name	Key	Required	Type	Description
Congress Number	congress	True	integer	The congress number. For example, value can be 117.
Response Format	format		string	The format of the response. Allowed values: xml, json.
Pagination Offset	offset		integer	The starting record returned. Default is 0 (first record).
Record Limit	limit		integer	The number of records returned. Maximum limit is 250.
Filter Start Date	fromDateTime		string	Starting timestamp for filtering treaties by update date. Format: YYYY-MM-DDT00:00:00Z.
Filter End Date	toDateTime		string	Ending timestamp for filtering treaties by update date. Format: YYYY-MM-DDT00:00:00Z.

Returns

Name	Path	Type
treaties	treaties	array of object
treatyTitle	treaties.treatyTitle	string
treatyNumber	treaties.treatyNumber	string
congress	treaties.congress	integer
updateDate	treaties.updateDate	date-time
updateDate	updateDate	date-time

Share via

US Congress CRS (Independent Publisher) (Preview)

Creating a connection

Default

Throttling Limits

Actions

Amendment: Get a list of amendments by congress

Parameters

Returns

Amendment: Get a list of amendments by date of latest action

Parameters

Returns

Amendment: Get amendments by congress and amendment type

Parameters

Returns

Amendment: Get detailed info for a specified amendment

Parameters

Returns

Amendment: Get the list of actions on a specified amendment

Parameters

Returns

Amendment: Get the list of amendments to a specified amendment

Parameters

Amendment: Get the list of cosponsors on a specified amendment

Parameters

Amendment: Get the list of text versions for a specified amendment

Parameters

Returns

Bills: Get a list of bills

Parameters

Returns

Bills: Get a list of bills by congress and bill type

Parameters

Returns

Bills: Get a list of bills by congress and latest action date

Parameters

Returns

Bills: Get detailed info for a specified bill

Parameters

Returns

Bills: Get the list of actions on a specified bill

Parameters

Returns

Bills: Get the list of amendments to a specified bill

Parameters

Returns

Bills: Get the list of committees associated with a specified bill

Parameters

Returns

Bills: Get the list of cosponsors on a specified bill

Parameters

Returns

Bills: Get the list of legislative subjects on a specified bill

Parameters

Returns

Bills: Get the list of related bills to a specified bill

Parameters

Returns

Bills: Get the list of text versions for a specified bill

Parameters

Returns

Bills: Get the list of titles for a specified bill

Parameters

Returns

Bound Congressional Record: Get a list of bound records

Parameters

Returns

Bound Congressional Record: Get bound records for a specified year and month

Parameters

Returns

Bound Congressional Record: Get bound records for a year, month, and day

Parameters

Returns

Bound Congressional Records: Get bound records for a specified year

Parameters

Returns

Committee Meeting: Get a list of committee meetings

Parameters

Returns

Committee Meeting: Get a list of committee meetings by congress