Share via


ProPublica Congress (Independent Publisher) (Preview)

Using the Congress API, you can retrieve legislative data from the House of Representatives, the Senate and the Library of Congress. The API, which originated at The New York Times in 2009, includes details about members, votes, bills, nominations and other aspects of congressional activity.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   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)
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)
Contact
Name Troy Taylor
URL https://www.hitachisolutions.com
Email ttaylor@hitachisolutions.com
Connector Metadata
Publisher Troy Taylor, Hitachi Solutions
Website https://projects.propublica.org/api-docs/congress-api/
Privacy policy https://www.propublica.org/legal/
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 The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Compare two members' bill sponsorships

This action compares bill sponsorship between two members who served in the same Congress and chamber.

Compare two members vote positions

This action compares two members' vote positions in a particular Congress and chamber. Responses include four calculated values, showing the number and percentage of votes in which the members took the same position or opposing positions.

Get a list of members

To get a list of members of a particular chamber in a particular Congress, use the following URI structure. The results include all members who have served in that congress and chamber, including members who are no longer in office. To filter the list to only active members (or to see members who have left), use the in office attribute.

Get a specific bill

This action gets details about a particular bill, including actions taken and votes. The attributes house_passage_vote and senate_passage_vote are populated (with the date of passage) only upon successful passage of the bill.

Get a specific committee

This action gets information about a single Senate or House committee, including the members of that committee.

Get a specific lobbying representation filing

This action gets a specific lobbying representation filing.

Get a specific member

This action gets biographical and Congressional role information for a particular member of Congress.

Get a specific member's vote positions

This action gets the most recent vote positions for a specific member of the House of Representatives or Senate.

Get a specific nomination

This action gets details about a particular presidential civilian nomination.

Get a specific roll call vote

This action gets a specific roll-call vote, including a complete list of member positions.

Get a specific subcommittee

This action gets information about a single Senate or House subcommittee, including the members of that subcommittee.

Get amendments for a specific bill

This action gets Library of Congress-assigned subjects about a particular bill. This request returns the 20 most recent results and supports paginated requests.

Get cosponsors for a specific bill

This action gets information about the cosponsors of a particular bill.

Get current members by state or district

This action gets biographical and Congressional role information for a particular member of Congress.

Get hearings for a specific committee

This actions gets a list of hearings for a specific Senate or House committee.

Get House and Senate floor actions by date

This action gets actions from the House or Senate floor on a particular date.

Get list of committees

This action gets a list of Senate, House or joint committees, including their subcommittees.

Get members leaving office

This action gets a list of members who have left the Senate or House or have announced plans to do so.

Get new members

This action gets a list of the most recent new members of the current Congress.

Get quarterly office expenses by a specific house member

The House of Representatives publishes quarterly reports detailing official office expenses by lawmakers. The Congress API has data beginning in the third quarter of 2009. The most recent quarter may not be available until several months after it ends.

Get quarterly office expenses by category for a specific house member

The House of Representatives publishes quarterly reports detailing official office expenses by lawmakers. The Congress API has data beginning in the third quarter of 2009. This action gets the amount a given lawmaker spent during a specified year and quarter in a specified category.

Get quarterly office expenses for a specific category

This action gets the amount spent by individual lawmakers in a specified category during a specified year and quarter by category.

Get recent bills

This action gets summaries of the 20 most recent bills by type. For the current Congress, recent bills can be one of four types (see the descriptions below). For previous Congresses, recent bills means the last 20 bills of that Congress.

Get recent bills by a specific member

This action gets the 20 bills most recently introduced or updated by a particular member.

Get recent bills by a specific subject

This action gets the 20 most recently updated bills for a specific legislative subject. Results can include more than one Congress.

Get recent committee hearings

This action gets a list of 20 upcoming Senate or House committee meetings.

Get recent House and Senate floor actions

This action gets the latest actions from the House or Senate floor.

Get recent lobbying representation filings

This action gets the most recent lobbying representation filings.

Get recent official communications

This action gets lists of official communications to Congress from the president, executive branch agencies and state legislatures to congressional committees.

Get recent official communications by category

This action gets lists of official communications to Congress in a specific category. It returns the 20 most recent results for the specified type: ec (Executive Communication), pm (Presidential Message) or pom (Petition or Memorial).

Get recent official communications by date

This action gets lists of official communications to Congress on a specific date.

Get recent personal explanations

This actions gets lists of personal explanations. Lawmakers, mostly in the House but also in the Senate, can make personal explanations for missed or mistaken votes in the Congressional Record. These explanations can refer to a single vote or to multiple votes.

Get recent personal explanations by a specific member

This action gets recent personal explanations by a specific member.

Get recent privately funded trips

This action gets a list of privately funded trips reported by all House members and staff in a particular Congress.

Get recent privately funded trips by a specific house member

This action gets a list of privately funded trips reported by a specific House member, including staff travel, in a particular Congress.

Get recent votes

This action returns recent votes from the House, Senate or both chambers. It returns the 20 most recent results, sorted by date and roll call number, and you can paginate through votes using the offset query string parameter that accepts multiples of 20.

Get related bills for a specific bill

This action gets Library of Congress-identified related bills for a particular bill. This request returns the 20 most recent results and supports paginated requests.

Get Senate nomination votes

This action gets Senate votes on presidential nominations. This request returns the 20 most recent results and supports paginated requests.

Get subjects for a specific bill

This action gets Library of Congress-assigned subjects about a particular bill. This request returns the 20 most recent results and supports paginated requests.

Get upcoming bills

This action gets details on bills that may be considered by the House or Senate in the near future, based on scheduled published or announced by congressional leadership. The bills and their potential consideration are taken from the House Majority Leader and floor updates from Senate Republicans.

Get votes by date

This action gets all votes in a particular date range (fewer than 30 days).

Get votes by type

This action returns vote information in four categories: missed votes, party votes, lone no votes and perfect votes.

Search bills

This action searches the title and full text of legislation by keyword to get the 20 most recent bills. Searches cover House and Senate bills from the 113th Congress through the current Congress (117th). If multiple words are given (e.g. query=health care) the search is treated as multiple keywords using the OR operator. Quoting the words (e.g. query="health care") makes it a phrase search. Search results can be sorted by date (the default) or by relevance, and in ascending or descending order.

Search lobbying representation filings

This actions gets the 20 most recent lobbying representation filings for a given search term.

Compare two members' bill sponsorships

This action compares bill sponsorship between two members who served in the same Congress and chamber.

Parameters

Name Key Required Type Description
First Member ID
first-member-id True string

The ID of the member to retrieve.

Second Member ID
second-member-id True string

The ID of the member to retrieve.

Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
First Member API Uri
results.first_member_api_uri string

The API Uri of the first member.

Second Member API Uri
results.second_member_api_uri string

The API Uri of the second member.

Chamber
results.chamber string

The chamber.

Congress
results.congress string

The Congressional session.

Common Bills
results.common_bills string

The common bills.

Bills
results.bills array of object
Number
results.bills.number string

The number.

API URI
results.bills.api_uri string

The API Uri.

Title
results.bills.title string

The title.

Sponsor Uri
results.bills.sponsor_uri string

The Uri of the sponsor.

Introduced Date
results.bills.introduced_date string

The introduced date.

Cosponsors
results.bills.cosponsors string

The cosponsors.

Committees
results.bills.committees string

The committees.

Latest Major Action Date
results.bills.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.bills.latest_major_action string

The latest major action.

First Member Date
results.bills.first_member_date string

The first member date.

Second Member Date
results.bills.second_member_date string

The second member date.

Compare two members vote positions

This action compares two members' vote positions in a particular Congress and chamber. Responses include four calculated values, showing the number and percentage of votes in which the members took the same position or opposing positions.

Parameters

Name Key Required Type Description
First Member ID
first-member-id True string

The ID of the member to retrieve.

Second Member ID
second-member-id True string

The ID of the member to retrieve.

Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
First Member ID
results.first_member_id string

The unique identifier of the first member.

First Member API Uri
results.first_member_api_uri string

The API Uri of the first member.

Second Member ID
results.second_member_id string

The unique identifier of the second member.

Second Member API Uri
results.second_member_api_uri string

The API Uri of the second member.

Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Common Votes
results.common_votes string

The common votes.

Disagree Votes
results.disagree_votes string

The Disagree votes.

Agree Percentage
results.agree_percent string

The Agree percentage.

Disagree Percentage
results.disagree_percent string

The Disagree percentage.

Get a list of members

To get a list of members of a particular chamber in a particular Congress, use the following URI structure. The results include all members who have served in that congress and chamber, including members who are no longer in office. To filter the list to only active members (or to see members who have left), use the in office attribute.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

In Office
in_office boolean

Whether an active member or member who has left.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Members
results.members array of object
ID
results.members.id string

The unique identifier.

Title
results.members.title string

The title.

Short Title
results.members.short_title string

The short title.

API URI
results.members.api_uri string

The API Uri.

First Name
results.members.first_name string

The first name.

Middle Name
results.members.middle_name string

The middle name.

Last Name
results.members.last_name string

The last name.

Suffix
results.members.suffix string

The suffix.

Date Of Birth
results.members.date_of_birth string

The date of birth.

Gender
results.members.gender string

The gender.

Party
results.members.party string

The party affiliation.

Leadership Role
results.members.leadership_role string

The leadership role.

Twitter Account
results.members.twitter_account string

The Twitter account.

Facebook Account
results.members.facebook_account string

The Facebook account.

YouTube Account
results.members.youtube_account string

The YouTube account.

Govtrack ID
results.members.govtrack_id string

The Govtrack identifier.

CSPAN ID
results.members.cspan_id string

The CSPAN identifier.

Votesmart ID
results.members.votesmart_id string

The Votesmart identifier.

ICPSR ID
results.members.icpsr_id string

The ICPSR identifier.

CRP ID
results.members.crp_id string

The CRP identifier.

Google Entity ID
results.members.google_entity_id string

The Google Entity identifier.

FEC Candidate ID
results.members.fec_candidate_id string

The FEC Candidate identifier.

URL
results.members.url string

The URL address.

RSS URL
results.members.rss_url string

The RSS URL.

Contact Form
results.members.contact_form string

The contact form.

In Office
results.members.in_office boolean

Whether in office or not.

Cook PVI
results.members.cook_pvi string

The Cook PVI.

DW-NOMINATE
results.members.dw_nominate float

The DW-NOMINATE score.

Ideal Point
results.members.ideal_point string

The ideal point.

Seniority
results.members.seniority string

The seniority.

Next Election
results.members.next_election string

The next election.

Total Votes
results.members.total_votes integer

The number of total votes.

Missed Votes
results.members.missed_votes integer

The number of missed votes.

Total Present
results.members.total_present integer

The total present.

Last Updated
results.members.last_updated string

When last updated .

OCD ID
results.members.ocd_id string

The OCD ID.

Office
results.members.office string

The office.

Phone
results.members.phone string

The phone number.

Fax
results.members.fax string

The fax number.

State
results.members.state string

The state.

Senate Class
results.members.senate_class string

The Senate class.

State Rank
results.members.state_rank string

The state rank.

LIS ID
results.members.lis_id string

The LIS identifier.

Missed Votes Percentage
results.members.missed_votes_pct float

The percentage of missed votes.

Votes With Party Percentage
results.members.votes_with_party_pct float

The percentage of votes with party.

Votes Against Party Percentage
results.members.votes_against_party_pct float

The percentage of votes against party.

Get a specific bill

This action gets details about a particular bill, including actions taken and votes. The attributes house_passage_vote and senate_passage_vote are populated (with the date of passage) only upon successful passage of the bill.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Bill ID
bill-id True string

A bill slug.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Bill ID
results.bill_id string

The unique identifier of the bill.

Bill Slug
results.bill_slug string

The bill slug.

Congress
results.congress string

The Congressional session.

Bill
results.bill string

The bill.

Bill Type
results.bill_type string

The bill type.

Number
results.number string

The number.

Bill Uri
results.bill_uri string

The Uri address of the bill.

Title
results.title string

The title.

Short Title
results.short_title string

The short title.

Sponsor Title
results.sponsor_title string

The sponsor title.

Sponsor
results.sponsor string

The sponsor.

Sponsor ID
results.sponsor_id string

The unique identifier of the sponsor.

Sponsor Uri
results.sponsor_uri string

The Uri address of the sponsor.

Sponsor Party
results.sponsor_party string

The party of the sponsor.

Sponsor State
results.sponsor_state string

The state of the sponsor.

GPO PDF Uri
results.gpo_pdf_uri string

The Uri address of the GPO PDF.

Congress.gov URL
results.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.govtrack_url string

The Govtrack URL.

Introduced Date
results.introduced_date string

The date introduced.

Active
results.active boolean

Whether active.

Last Vote
results.last_vote string

The last vote.

House Passage
results.house_passage string

The House passage.

Senate Passage
results.senate_passage string

The Senate passage.

Enacted
results.enacted string

When enacted.

Vetoed
results.vetoed string

When vetoed.

Cosponsors
results.cosponsors integer

The cosponsors.

Republicans
results.cosponsors_by_party.R integer

The number of Republicans.

Democrats
results.cosponsors_by_party.D integer

The number of Democrats.

Independents
results.cosponsors_by_party.I integer

The number of Independents.

Withdrawn Cosponsors
results.withdrawn_cosponsors integer

The number of withdrawn cosponsors.

Primary Subject
results.primary_subject string

The primary subject.

Committees
results.committees string

The committees.

Committee Codes
results.committee_codes array of string
Subcommittee Codes
results.subcommittee_codes array of string
Latest Major Action Date
results.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.latest_major_action string

The latest major action.

House Passage Vote
results.house_passage_vote string

The House passage vote.

Senate Passage Vote
results.senate_passage_vote string

The Senate passage vote.

Summary
results.summary string

The summary.

Summary Short
results.summary_short string

The short summary.

CBO Estimate URL
results.cbo_estimate_url string

The URL address of the CBO estimate.

Versions
results.versions array of object
Status
results.versions.status string

The status.

Title
results.versions.title string

The title.

URL
results.versions.url string

The URL address.

Congress.gov URL
results.versions.congressdotgov_url string

The Congress.gov URL address.

Actions
results.actions array of object
ID
results.actions.id integer

The unique identifier.

Chamber
results.actions.chamber string

The chamber.

Action Type
results.actions.action_type string

The action type.

Date-time
results.actions.datetime string

The date-time.

Description
results.actions.title string

The description.

Presidential Statements
results.presidential_statements array of string
Votes
results.votes array of object
Chamber
results.votes.chamber string

The chamber.

Date
results.votes.date string

The date.

Time
results.votes.time string

The time.

Roll Call
results.votes.roll_call string

The roll call.

Question
results.votes.question string

The question.

Result
results.votes.result string

The result.

Total Yes
results.votes.total_yes integer

The Yes total.

Total No
results.votes.total_no integer

The No total.

Total Not Voting
results.votes.total_not_voting integer

The Not Voting total.

API URL
results.votes.api_url string

The URL address of the API.

Get a specific committee

This action gets information about a single Senate or House committee, including the members of that committee.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Committee ID
committee-id True string

The unique identifier of the committee.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

ID
results.id string

The unique identifier.

Name
results.name string

The name.

URL
results.url string

The URL address.

Number of Results
results.num_results integer

The number of results.

Chair
results.chair string

The chair.

Chair ID
results.chair_id string

The unique identifier of the chair.

Chair Party
results.chair_party string

The party of the chair.

Chair State
results.chair_state string

The state of the chair.

Ranking Member ID
results.ranking_member_id string

The unique identifier of the ranking member.

Current Members
results.current_members array of object
ID
results.current_members.id string

The unique identifier.

Name
results.current_members.name string

The name.

API URI
results.current_members.api_uri string

The API Uri.

Party
results.current_members.party string

The party affiliation.

Chamber
results.current_members.chamber string

The chamber.

Side
results.current_members.side string

The side.

Rank In Party
results.current_members.rank_in_party integer

The rank in party.

State
results.current_members.state string

The state.

Note
results.current_members.note string

Any notes.

Begin Date
results.current_members.begin_date string

The begin date.

Former Members
results.former_members array of object
ID
results.former_members.id string

The unique identifier.

Name
results.former_members.name string

The name.

Party
results.former_members.party string

The party affiliation.

Chamber
results.former_members.chamber string

The chamber.

State
results.former_members.state string

The state.

Note
results.former_members.note string

Any notes.

Begin Date
results.former_members.begin_date string

The begin date.

End Date
results.former_members.end_date string

The end date.

URL
results.former_members.url string

The URL address.

Subcommittees
results.subcommittees array of object
ID
results.subcommittees.id string

The unique identifier.

Name
results.subcommittees.name string

The name.

API URI
results.subcommittees.api_uri string

The API Uri.

Get a specific lobbying representation filing

This action gets a specific lobbying representation filing.

Parameters

Name Key Required Type Description
ID
id True string

The unique identifier.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Name
results.lobbying_client.name string

The name.

General Description
results.lobbying_client.general_description string

The general description.

Name
results.lobbying_registrant.name string

The name.

General Description
results.lobbying_registrant.general_description string

The general description.

In-house
results.inhouse string

The in-house.

Signed Date
results.signed_date string

The signed date.

Effective Date
results.effective_date string

The effective date.

XML Filename
results.xml_filename string

The XML filename.

ID
results.id string

The unique identifier.

Specific Issues
results.specific_issues array of string
Report Type
results.report_type string

The report type.

Report Year
results.report_year string

The report year.

Senate ID
results.senate_id string

The Senate unique identifier.

House ID
results.house_id string

The House unique identifier.

Filings
results.filings array of object
Filing Date
results.filings.filing_date string

The filing date.

Report Year
results.filings.report_year string

The report year.

Report Type
results.filings.report_type string

The report type.

PDF URL
results.filings.pdf_url string

The URL address of the PDF.

Lobbyists
results.lobbyists array of object
Name
results.lobbyists.name string

The name.

Covered Position
results.lobbyists.covered_position string

The covered position.

Get a specific member

This action gets biographical and Congressional role information for a particular member of Congress.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
ID
results.id string

The unique identifier.

Member ID
results.member_id string

The member identifier.

First Name
results.first_name string

The first name.

Middle Name
results.middle_name string

The middle name.

Last Name
results.last_name string

The last name.

Suffix
results.suffix string

The suffix.

Date Of Birth
results.date_of_birth string

The date of birth.

Gender
results.gender string

The gender.

URL
results.url string

The URL address.

Times Topics URL
results.times_topics_url string

The Times Topics URL address.

Times Tag
results.times_tag string

The Times tag.

Govtrack ID
results.govtrack_id string

The Govtrack identifier.

CSPAN ID
results.cspan_id string

The CSPAN identifier.

Votesmart ID
results.votesmart_id string

The Votesmart identifier.

ICPSR ID
results.icpsr_id string

The ICPSR identifier.

Twitter Account
results.twitter_account string

The Twitter account.

Facebook Account
results.facebook_account string

The Facebook account.

YouTube Account
results.youtube_account string

The YouTube account.

CRP ID
results.crp_id string

The CRP identifier.

Google Entity ID
results.google_entity_id string

The Google Entity identifier.

RSS URL
results.rss_url string

The RSS URL address.

In Office
results.in_office boolean

Whether in office or not.

Current Party
results.current_party string

The current party.

Most Recent Vote
results.most_recent_vote string

The most recent vote.

Last Updated
results.last_updated string

When last updated.

Roles
results.roles array of object
Congress
results.roles.congress string

The Congress session.

Chamber
results.roles.chamber string

The chamber.

Title
results.roles.title string

The title.

Short Title
results.roles.short_title string

The short title.

State
results.roles.state string

The state.

Party
results.roles.party string

The party affiliation.

Leadership Role
results.roles.leadership_role string

The leadership role.

FEC Candidate ID
results.roles.fec_candidate_id string

The FEC Candidate identifier.

Seniority
results.roles.seniority string

The seniority.

District
results.roles.district string

The district.

At Large
results.roles.at_large boolean

Whether at large or not.

OCD ID
results.roles.ocd_id string

The OCD ID.

Start Date
results.roles.start_date string

The start date.

End Date
results.roles.end_date string

The end date.

Office
results.roles.office string

The office.

Phone
results.roles.phone string

The phone number.

Fax
results.roles.fax string

The fax number.

Contact Form
results.roles.contact_form string

The contact form.

Cook PVI
results.roles.cook_pvi string

The Cook PVI.

DW-NOMINATE
results.roles.dw_nominate float

The DW-NOMINATE score.

Ideal Point
results.roles.ideal_point string

The Ideal point.

Next Election
results.roles.next_election string

The next election.

Total Votes
results.roles.total_votes integer

The number of total votes.

Missed Votes
results.roles.missed_votes integer

The number of missed votes.

Total Present
results.roles.total_present integer

The total present.

Senate Class
results.roles.senate_class string

The Senate class.

State Rank
results.roles.state_rank string

The state rank.

LIS ID
results.roles.lis_id string

The LIS identifier.

Bills Sponsored
results.roles.bills_sponsored integer

The number of bills sponsored.

Bills Cosponsored
results.roles.bills_cosponsored integer

The number of bills cosponsored.

Missed Votes Percentage
results.roles.missed_votes_pct float

The percentage of missed votes.

Votes With Party Percentage
results.roles.votes_with_party_pct float

The percentage of votes with party.

Votes Against Party Percentage
results.roles.votes_against_party_pct float

The percentage of votes against party.

Committees
results.roles.committees array of object
Name
results.roles.committees.name string

The name.

Code
results.roles.committees.code string

The code.

API URI
results.roles.committees.api_uri string

The API Uri address.

Side
results.roles.committees.side string

The side.

Title
results.roles.committees.title string

The title.

Rank In Party
results.roles.committees.rank_in_party integer

The rank in party.

Begin Date
results.roles.committees.begin_date string

The begin date.

End Date
results.roles.committees.end_date string

The end date.

Subcommittees
results.roles.subcommittees array of object
Name
results.roles.subcommittees.name string

The name.

Code
results.roles.subcommittees.code string

The code.

Parent Committee ID
results.roles.subcommittees.parent_committee_id string

The parent committee identifier.

API URI
results.roles.subcommittees.api_uri string

The API Uri address.

Side
results.roles.subcommittees.side string

The side.

Title
results.roles.subcommittees.title string

The title.

Rank In Party
results.roles.subcommittees.rank_in_party integer

The rank in party.

Begin Date
results.roles.subcommittees.begin_date string

The begin date.

End Date
results.roles.subcommittees.end_date string

The end date.

Get a specific member's vote positions

This action gets the most recent vote positions for a specific member of the House of Representatives or Senate.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Member ID
results.member_id string

The member identifier.

Total Votes
results.total_votes string

The total votes.

Offset
results.offset string

The requested pagination offset.

Votes
results.votes array of object
Member ID
results.votes.member_id string

The unique identifier of the member.

Chamber
results.votes.chamber string

The chamber.

Congress
results.votes.congress string

The Congress session.

Session
results.votes.session string

The session.

Roll Call
results.votes.roll_call string

The roll call.

Vote Uri
results.votes.vote_uri string

The vote Uri.

Bill ID
results.votes.bill.bill_id string

The unique identifier of the bill.

Number
results.votes.bill.number string

The number.

Bill Uri
results.votes.bill.bill_uri string

The bill Uri.

Title
results.votes.bill.title string

The title.

Latest Action
results.votes.bill.latest_action string

The latest action.

Description
results.votes.title string

The description.

Question
results.votes.question string

The question.

Result
results.votes.result string

The result.

Date
results.votes.date string

The date.

Time
results.votes.time string

The time.

Yes
results.votes.total.yes integer

The Yes votes.

No
results.votes.total.no integer

The No votes.

Present
results.votes.total.present integer

The Present votes.

Not Voting
results.votes.total.not_voting integer

The Not Voting number.

Position
results.votes.position string

The position.

Get a specific nomination

This action gets details about a particular presidential civilian nomination.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Nominee ID
nominee-id True string

The unique identifier of the nominee, beginning with PN - for example, PN675.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress integer

The Congressional session.

ID
results.id string

The unique identifier.

Date Received
results.date_received string

The date received.

Description
results.description string

The description.

Nominee State
results.nominee_state string

The state of the nominee.

Committee Uri
results.committee_uri string

The Uri address of the committee.

Latest Action Date
results.latest_action_date string

The date of the latest action.

Status
results.status string

The status.

Actions
results.actions array of object
Date
results.actions.date string

The date.

Description
results.actions.title string

The description.

Votes
results.votes array of object
Uri
results.votes.uri string

The Uri address.

Date
results.votes.date string

The date.

Roll Call
results.votes.roll_call integer

The roll call.

Question
results.votes.question string

The question.

Result
results.votes.result string

The result.

Total Yes
results.votes.total_yes integer

The Yes total.

Total No
results.votes.total_no integer

The No total.

Total Not Voting
results.votes.total_not_voting integer

The Not Voting total.

Get a specific roll call vote

This action gets a specific roll-call vote, including a complete list of member positions.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Session Number
session-number True string

1 or 2, depending on year (1 is odd-numbered years, 2 is even-numbered years).

Roll Call Number
roll-call-number True integer

The number of the roll call.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Congress
results.votes.vote.congress integer

The Congress session.

Session
results.votes.vote.session integer

The session.

Chamber
results.votes.vote.chamber string

The chamber.

Roll Call
results.votes.vote.roll_call integer

The roll call.

Source
results.votes.vote.source string

The source.

URL
results.votes.vote.url string

The URL address.

Bill ID
results.votes.vote.bill.bill_id string

The unique identifier of the bill.

Number
results.votes.vote.bill.number string

The number.

API URI
results.votes.vote.bill.api_uri string

The Uri address of the API.

Title
results.votes.vote.bill.title string

The title.

Latest Action
results.votes.vote.bill.latest_action string

The latest action.

Question
results.votes.vote.question string

The question.

Description
results.votes.vote.title string

The description.

Vote Type
results.votes.vote.vote_type string

The vote type.

Date
results.votes.vote.date string

The date.

Time
results.votes.vote.time string

The time.

Result
results.votes.vote.result string

The result.

Tie Breaker
results.votes.vote.tie_breaker string

The tie breaker.

Tie Breaker Vote
results.votes.vote.tie_breaker_vote string

The tie breaker vote.

Document Number
results.votes.vote.document_number string

The document number.

Document Title
results.votes.vote.document_title string

The document title.

Yes
results.votes.vote.democratic.yes integer

The Yes votes.

No
results.votes.vote.democratic.no integer

The No votes.

Present
results.votes.vote.democratic.present integer

The Present votes.

Not Voting
results.votes.vote.democratic.not_voting integer

The Not Voting number.

Majority Position
results.votes.vote.democratic.majority_position string

The majority position.

Yes
results.votes.vote.republican.yes integer

The Yes votes.

No
results.votes.vote.republican.no integer

The No votes.

Present
results.votes.vote.republican.present integer

The Present votes.

Not Voting
results.votes.vote.republican.not_voting integer

The Not Voting number.

Majority Position
results.votes.vote.republican.majority_position string

The majority position.

Yes
results.votes.vote.independent.yes integer

The Yes votes.

No
results.votes.vote.independent.no integer

The No votes.

Present
results.votes.vote.independent.present integer

The Present votes.

Not Voting
results.votes.vote.independent.not_voting integer

The Not Voting number.

Yes
results.votes.vote.total.yes integer

The Yes votes.

No
results.votes.vote.total.no integer

The No votes.

Present
results.votes.vote.total.present integer

The Present votes.

Not Voting
results.votes.vote.total.not_voting integer

The Not Voting number.

Positions
results.votes.vote.positions array of object
Member ID
results.votes.vote.positions.member_id string

The unique identifier of the member.

Name
results.votes.vote.positions.name string

The name.

Party
results.votes.vote.positions.party string

The party.

State
results.votes.vote.positions.state string

The state.

Vote Position
results.votes.vote.positions.vote_position string

The vote position.

DW-NOMINATE
results.votes.vote.positions.dw_nominate float

The DW-NOMINATE score.

Vacant Seats
results.votes.vacant_seats array of string

Get a specific subcommittee

This action gets information about a single Senate or House subcommittee, including the members of that subcommittee.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Committee ID
committee-id True string

The unique identifier of the committee.

Subcommittee ID
subcommittee-id True string

The unique identifier of the subcommittee.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

ID
results.id string

The unique identifier.

Name
results.name string

The name.

Committee ID
results.committee_id string

The unique identifier of the committee.

Committee Name
results.committee_name string

The name of the committee.

Committee URL
results.committee_url string

The URL address of the committee.

Chair
results.chair string

The chair.

Chair ID
results.chair_id string

The unique identifier of the chair.

Chair Party
results.chair_party string

The party of the chair.

Chair State
results.chair_state string

The state of the chair.

Ranking Member ID
results.ranking_member_id string

The unique identifier of the ranking member.

Number of Results
results.num_results integer

The number of results.

Current Members
results.current_members array of object
ID
results.current_members.id string

The unique identifier.

Name
results.current_members.name string

The name.

API URI
results.current_members.api_uri string

The API Uri.

Party
results.current_members.party string

The party affiliation.

Side
results.current_members.side string

The side.

Rank In Party
results.current_members.rank_in_party integer

The rank in party.

State
results.current_members.state string

The state.

Note
results.current_members.note string

Any notes.

Begin Date
results.current_members.begin_date string

The begin date.

Former Members
results.former_members array of string

Get amendments for a specific bill

This action gets Library of Congress-assigned subjects about a particular bill. This request returns the 20 most recent results and supports paginated requests.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Bill ID
bill-id True string

A bill slug.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Bill ID
results.bill_id string

The unique identifier of the bill.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Amendments
results.amendments array of object
Amendment Number
results.amendments.amendment_number string

The number of amendments.

Slug
results.amendments.slug string

The slug.

Sponsor Title
results.amendments.sponsor_title string

The sponsor title.

Sponsor
results.amendments.sponsor string

The sponsor.

Sponsor ID
results.amendments.sponsor_id string

The unique identifier of the sponsor.

Sponsor Uri
results.amendments.sponsor_uri string

The Uri of the sponsor.

Sponsor Party
results.amendments.sponsor_party string

The party of the sponsor.

Sponsor State
results.amendments.sponsor_state string

The state of the sponsor.

Introduced Date
results.amendments.introduced_date string

The introduced date.

Title
results.amendments.title string

The title.

Congress.gov URL
results.amendments.congressdotgov_url string

The Congress.gov URL address.

Latest Major Action Date
results.amendments.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.amendments.latest_major_action string

The latest major action.

Get cosponsors for a specific bill

This action gets information about the cosponsors of a particular bill.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Bill ID
bill-id True string

A bill slug.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Bill
results.bill string

The bill.

URL Number
results.url_number string

The number of URLs.

Title
results.title string

The title.

Sponsor Title
results.sponsor_title string

The sponsor title.

Sponsor ID
results.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.sponsor_name string

The name of the sponsor.

Sponsor State
results.sponsor_state string

The state of the sponsor.

Sponsor Party
results.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.sponsor_uri string

The Uri address of the sponsor.

Introduced Date
results.introduced_date string

The date introduced.

Number Of Cosponsors
results.number_of_cosponsors integer

The number of cosponsors.

Committees
results.committees string

The committees.

Latest Major Action Date
results.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.latest_major_action string

The latest major action.

House Passage Vote
results.house_passage_vote string

The House passage vote.

Senate Passage Vote
results.senate_passage_vote string

The Senate passage vote.

Cosponsors By Party
results.cosponsors_by_party array of object
ID
results.cosponsors_by_party.party.id string

The unique identifier.

Sponsors
results.cosponsors_by_party.party.sponsors string

The sponsors.

Cosponsors
results.cosponsors array of object
Cosponsor ID
results.cosponsors.cosponsor_id string

The unique identifier of the cosponsor.

Name
results.cosponsors.name string

The name.

Cosponsor Title
results.cosponsors.cosponsor_title string

The cosponsor title.

Cosponsor State
results.cosponsors.cosponsor_state string

The state of the cosponsor.

Cosponsor Party
results.cosponsors.cosponsor_party string

The party of the cosponsor.

Cosponsor Uri
results.cosponsors.cosponsor_uri string

The Uri address of the cosponsor.

Date
results.cosponsors.date string

The date.

Get current members by state or district

This action gets biographical and Congressional role information for a particular member of Congress.

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

State
state True string

The two-letter state abbreviation.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
ID
results.id string

The unique identifier.

Name
results.name string

The name.

First Name
results.first_name string

The first name.

Middle Name
results.middle_name string

The middle name.

Last Name
results.last_name string

The last name.

Suffix
results.suffix string

The suffix.

Role
results.role string

The role.

Gender
results.gender string

The gender.

Party
results.party string

The party.

Times Topics URL
results.times_topics_url string

The Times Topics URL address.

Twitter ID
results.twitter_id string

The Twitter identifier.

Facebook Account
results.facebook_account string

The Facebook account.

YouTube ID
results.youtube_id string

The YouTube identifier.

Seniority
results.seniority string

The seniority.

Next Election
results.next_election string

The next election.

API URI
results.api_uri string

The API Uri address.

Get hearings for a specific committee

This actions gets a list of hearings for a specific Senate or House committee.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Committee ID
committee-id True string

The unique identifier of the committee.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Hearings
results.hearings array of object
Chamber
results.hearings.chamber string

The chamber.

Committee
results.hearings.committee string

The committee.

Committee Code
results.hearings.committee_code string

The committee code.

API URI
results.hearings.api_uri string

The API Uri.

Date
results.hearings.date string

The date.

Time
results.hearings.time string

The time.

Location
results.hearings.location string

The location.

Description
results.hearings.title string

The description.

Bill IDs
results.hearings.bill_ids array of string
URL
results.hearings.url string

The URL address.

Meeting Type
results.hearings.meeting_type string

The type of meeting.

Get House and Senate floor actions by date

This action gets actions from the House or Senate floor on a particular date.

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

Year
year True string

The year in the format YYYY.

Month
month True string

The month in MM format.

Date
day True string

The day in dd format.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Date
results.date string

The date.

Number of Results
results.num_results string

The number of results.

Offset
results.offset string

The requested pagination offset.

Floor Actions
results.floor_actions array of object
Timestamp
results.floor_actions.timestamp string

The timestamp.

Date
results.floor_actions.date string

The date.

Action ID
results.floor_actions.action_id string

The unique identifier of the action.

Description
results.floor_actions.title string

The description.

Get list of committees

This action gets a list of Senate, House or joint committees, including their subcommittees.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Number of Results
results.num_results integer

The number of results.

Committees
results.committees array of object
ID
results.committees.id string

The unique identifier.

Name
results.committees.name string

The name.

Chamber
results.committees.chamber string

The chamber.

URL
results.committees.url string

The URL address.

API URI
results.committees.api_uri string

The API Uri.

Chair
results.committees.chair string

The chair.

Chair ID
results.committees.chair_id string

The unique identifier of the chair.

Chair Party
results.committees.chair_party string

The party of the chair.

Chair State
results.committees.chair_state string

The state of the chair.

Chair Uri
results.committees.chair_uri string

The Uri address of the chair.

Ranking Member ID
results.committees.ranking_member_id string

The unique identifier of the ranking member.

Subcommittees
results.committees.subcommittees array of object
ID
results.committees.subcommittees.id string

The unique identifier.

Name
results.committees.subcommittees.name string

The name.

API URI
results.committees.subcommittees.api_uri string

The API Uri address.

Get members leaving office

This action gets a list of members who have left the Senate or House or have announced plans to do so.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Members
results.members array of object
ID
results.members.id string

The unique identifier.

API URI
results.members.api_uri string

The API Uri.

First Name
results.members.first_name string

The first name.

Middle Name
results.members.middle_name string

The middle name.

Last Name
results.members.last_name string

The last name.

Suffix
results.members.suffix string

The suffix.

Party
results.members.party string

The party affiliation.

State
results.members.state string

The state.

District
results.members.district string

The district.

Begin Date
results.members.begin_date string

The begin date.

End Date
results.members.end_date string

The end date.

Status
results.members.status string

The status.

Note
results.members.note string

Any notes.

Get new members

This action gets a list of the most recent new members of the current Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Number of Results
results.num_results string

The number of results.

Offset
results.offset string

The requested pagination offset.

Members
results.members array of object
ID
results.members.id string

The unique identifier.

API URI
results.members.api_uri string

The API Uri.

First Name
results.members.first_name string

The first name.

Middle Name
results.members.middle_name string

The middle name.

Last Name
results.members.last_name string

The last name.

Suffix
results.members.suffix string

The suffix.

Party
results.members.party string

The party affiliation.

Chamber
results.members.chamber string

The chamber.

State
results.members.state string

The state.

District
results.members.district string

The district.

Start Date
results.members.start_date string

The start date.

Get quarterly office expenses by a specific house member

The House of Representatives publishes quarterly reports detailing official office expenses by lawmakers. The Congress API has data beginning in the third quarter of 2009. The most recent quarter may not be available until several months after it ends.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Year
year True string

The year in the format YYYY.

Quarter
quarter True string

The quarter number as a single digit.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Member ID
member_id string

The unique identifier of the member.

Name
name string

The name.

Member Uri
member_uri string

The Uri of the member.

Year
year integer

The year.

Quarter
quarter integer

The quarter.

Results
num_results integer

The number of results.

Results
results array of object
Category
results.category string

The category.

Category Slug
results.category_slug string

The category slug.

Amount
results.amount float

The amount.

Year To Date
results.year_to_date float

The year to date amount.

Change From Previous Quarter
results.change_from_previous_quarter float

The change from previous quarter.

Get quarterly office expenses by category for a specific house member

The House of Representatives publishes quarterly reports detailing official office expenses by lawmakers. The Congress API has data beginning in the third quarter of 2009. This action gets the amount a given lawmaker spent during a specified year and quarter in a specified category.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Category
category True string

The expense category.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Member ID
member_id string

The unique identifier of the member.

Name
name string

The name.

Member Uri
member_uri string

The Uri of the member.

Category
category string

The category.

Results
num_results integer

The number of results.

Results
results array of object
Year
results.year integer

The year.

Quarter
results.quarter integer

The quarter.

Amount
results.amount float

The amount.

Year To Date
results.year_to_date float

The year to date amount.

Change From Previous Quarter
results.change_from_previous_quarter integer

The change from previous quarter.

Get quarterly office expenses for a specific category

This action gets the amount spent by individual lawmakers in a specified category during a specified year and quarter by category.

Parameters

Name Key Required Type Description
Category
category True string

The expense category.

Year
year True string

The year in the format YYYY.

Quarter
quarter True string

The quarter number as a single digit.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Category
category string

The category.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Year
results.year integer

The year.

Quarter
results.quarter integer

The quarter.

Member ID
results.member_id string

The member identifier.

Name
results.name string

The name.

Member Uri
results.member_uri string

The Uri of the member.

Amount
results.amount float

The amount.

Year To Date
results.year_to_date float

The year to date amount.

Change From Previous Quarter
results.change_from_previous_quarter float

The change from previous quarter.

Get recent bills

This action gets summaries of the 20 most recent bills by type. For the current Congress, recent bills can be one of four types (see the descriptions below). For previous Congresses, recent bills means the last 20 bills of that Congress.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Type
type True string

Whether the bill was cosponsored or withdrawn.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress integer

The Congressional session.

Chamber
results.chamber string

The chamber.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Bills
results.bills array of object
Bill ID
results.bills.bill_id string

The unique identifier of the bill.

Bill Slug
results.bills.bill_slug string

The bill slug.

Bill Type
results.bills.bill_type string

The type of bill.

Number
results.bills.number string

The number.

Bill Uri
results.bills.bill_uri string

The Uri of the bill.

Title
results.bills.title string

The title.

Short Title
results.bills.short_title string

The short title.

Sponsor Title
results.bills.sponsor_title string

The sponsor title.

Sponsor ID
results.bills.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.bills.sponsor_name string

The name of the sponsor.

Sponsor State
results.bills.sponsor_state string

The state of the sponsor.

Sponsor Party
results.bills.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.bills.sponsor_uri string

The Uri of the sponsor.

GPO PDF Uri
results.bills.gpo_pdf_uri string

The Uri of the GPO PDF.

Congress.gov URL
results.bills.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.bills.govtrack_url string

The Govtrack URL address.

Introduced Date
results.bills.introduced_date string

The introduced date.

Active
results.bills.active boolean

Whether active.

Last Vote
results.bills.last_vote string

The last vote.

House Passage
results.bills.house_passage string

The House passage.

Senate Passage
results.bills.senate_passage string

The Senate passage.

Enacted
results.bills.enacted string

The enacted.

Vetoed
results.bills.vetoed string

The vetoed.

Cosponsors
results.bills.cosponsors integer

The cosponsors.

Democrats
results.bills.cosponsors_by_party.D integer

The number of Democrats.

Republicans
results.bills.cosponsors_by_party.R integer

The number of Republicans.

I
results.bills.cosponsors_by_party.I integer

The number of Independents.

Committees
results.bills.committees string

The committees.

Committee Codes
results.bills.committee_codes array of string
Subcommittee Codes
results.bills.subcommittee_codes array of string
Primary Subject
results.bills.primary_subject string

The primary subject.

Summary
results.bills.summary string

The summary.

Short Summary
results.bills.summary_short string

The short summary.

Latest Major Action Date
results.bills.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.bills.latest_major_action string

The latest major action.

Get recent bills by a specific member

This action gets the 20 bills most recently introduced or updated by a particular member.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Type
type True string

Whether the bill was cosponsored or withdrawn.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
ID
results.id string

The unique identifier.

Member Uri
results.member_uri string

The Uri of the member.

Name
results.name string

The name.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Bills
results.bills array of object
Congress
results.bills.congress string

The Congress session.

Bill ID
results.bills.bill_id string

The unique identifier of the bill.

Bill Type
results.bills.bill_type string

The type of bill.

Number
results.bills.number string

The number.

Bill Uri
results.bills.bill_uri string

The Uri of the bill.

Title
results.bills.title string

The title.

Short Title
results.bills.short_title string

The short title.

Sponsor Title
results.bills.sponsor_title string

The sponsor title.

Sponsor ID
results.bills.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.bills.sponsor_name string

The name of the sponsor.

Sponsor State
results.bills.sponsor_state string

The state of the sponsor.

Sponsor Party
results.bills.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.bills.sponsor_uri string

The Uri of the sponsor.

GPO PDF Uri
results.bills.gpo_pdf_uri string

The Uri of the GPO PDF.

Congress.gov URL
results.bills.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.bills.govtrack_url string

The Govtrack URL address.

Introduced Date
results.bills.introduced_date string

The introduced date.

Active
results.bills.active boolean

Whether active.

Last Vote
results.bills.last_vote string

The last vote.

House Passage
results.bills.house_passage string

The House passage.

Senate Passage
results.bills.senate_passage string

The Senate passage.

Enacted
results.bills.enacted string

The enacted.

Vetoed
results.bills.vetoed string

The vetoed.

Cosponsors
results.bills.cosponsors integer

The cosponsors.

Democrats
results.bills.cosponsors_by_party.D integer

The number of Democrats.

Republicans
results.bills.cosponsors_by_party.R integer

The number of Republicans.

Independents
results.bills.cosponsors_by_party.I integer

The number of Independents.

Committees
results.bills.committees string

The committees.

Primary Subject
results.bills.primary_subject string

The primary subject.

Summary
results.bills.summary string

The summary.

Short Summary
results.bills.summary_short string

The short summary.

Latest Major Action Date
results.bills.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.bills.latest_major_action string

The latest major action.

Get recent bills by a specific subject

This action gets the 20 most recently updated bills for a specific legislative subject. Results can include more than one Congress.

Parameters

Name Key Required Type Description
Subject
subject True string

A slug version of a legislative subject, displayed as URL Name in subject responses.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Subject
subject string

The subject.

Results
results array of object
Bill ID
results.bill_id string

The unique identifier of the bill.

Bill Slug
results.bill_slug string

The bill slug.

Bill Type
results.bill_type string

The bill type.

Number
results.number string

The number.

Bill Uri
results.bill_uri string

The Uri address of the bill.

Title
results.title string

The title.

Short Title
results.short_title string

The short title.

Sponsor ID
results.sponsor_id string

The unique identifier of the sponsor.

Sponsor Uri
results.sponsor_uri string

The Uri address of the sponsor.

Sponsor Title
results.sponsor_title string

The sponsor title.

Sponsor Name
results.sponsor_name string

The name of the sponsor.

Sponsor State
results.sponsor_state string

The state of the sponsor.

Sponsor Party
results.sponsor_party string

The party of the sponsor.

Introduced Date
results.introduced_date string

The date introduced.

Cosponsors
results.cosponsors integer

The cosponsors.

Republicans
results.cosponsors_by_party.R integer

The number of Republicans.

Democrats
results.cosponsors_by_party.D integer

The number of Democrats.

Independents
results.cosponsors_by_party.I integer

The number of Independents.

Committees
results.committees string

The committees.

Committee Codes
results.committee_codes array of string
Subcommittee Codes
results.subcommittee_codes array of string
Primary Subject
results.primary_subject string

The primary subject.

Latest Major Action Date
results.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.latest_major_action string

The latest major action.

Active
results.active boolean

Whether active.

Last Vote
results.last_vote string

The last vote.

Enacted
results.enacted string

When enacted.

Vetoed
results.vetoed string

When vetoed.

GPO PDF Uri
results.gpo_pdf_uri string

The Uri address of the GPO PDF.

Congress.gov URL
results.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.govtrack_url string

The Govtrack URL.

House Passage
results.house_passage string

The House passage.

Senate Passage
results.senate_passage string

The Senate passage.

Summary
results.summary string

The summary.

Summary Short
results.summary_short string

The short summary.

Get recent committee hearings

This action gets a list of 20 upcoming Senate or House committee meetings.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Hearings
results.hearings array of object
Chamber
results.hearings.chamber string

The chamber.

Committee
results.hearings.committee string

The committee.

Committee Code
results.hearings.committee_code string

The committee code.

API URI
results.hearings.api_uri string

The API Uri.

Date
results.hearings.date string

The date.

Time
results.hearings.time string

The time.

Location
results.hearings.location string

The location.

Description
results.hearings.title string

The description.

Bill IDs
results.hearings.bill_ids array of string
URL
results.hearings.url string

The URL address.

Meeting Type
results.hearings.meeting_type string

The type of meeting.

Get recent House and Senate floor actions

This action gets the latest actions from the House or Senate floor.

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Chamber
results.chamber string

The chamber.

Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Floor Actions
results.floor_actions array of object
Congress
results.floor_actions.congress string

The Congress session.

Chamber
results.floor_actions.chamber string

The chamber.

Timestamp
results.floor_actions.timestamp string

The timestamp.

Date
results.floor_actions.date string

The date.

Action ID
results.floor_actions.action_id string

The unique identifier of the action.

Description
results.floor_actions.title string

The description.

Bill IDs
results.floor_actions.bill_ids array of string

Get recent lobbying representation filings

This action gets the most recent lobbying representation filings.

Parameters

Name Key Required Type Description
Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Lobbying Representations
results.lobbying_representations array of object
Name
results.lobbying_representations.lobbying_client.name string

The name.

General Description
results.lobbying_representations.lobbying_client.general_description string

The general description.

Name
results.lobbying_representations.lobbying_registrant.name string

The name.

General Description
results.lobbying_representations.lobbying_registrant.general_description string

The general description.

In-house
results.lobbying_representations.inhouse string

The in-house.

Signed Date
results.lobbying_representations.signed_date string

The signed date.

Effective Date
results.lobbying_representations.effective_date string

The effective date.

XML Filename
results.lobbying_representations.xml_filename string

The XML filename.

ID
results.lobbying_representations.id string

The unique identifier.

Specific Issues
results.lobbying_representations.specific_issues array of string
Report Type
results.lobbying_representations.report_type string

The report type.

Report Year
results.lobbying_representations.report_year string

The report year.

Senate ID
results.lobbying_representations.senate_id string

The Senate unique identifier.

House ID
results.lobbying_representations.house_id string

The House unique identifier.

Filing Date
results.lobbying_representations.latest_filing.filing_date string

The filing date.

Report Year
results.lobbying_representations.latest_filing.report_year string

The report year.

Report Type
results.lobbying_representations.latest_filing.report_type string

The report type.

PDF URL
results.lobbying_representations.latest_filing.pdf_url string

The URL address of the PDF.

Lobbyists
results.lobbying_representations.lobbyists array of object
Name
results.lobbying_representations.lobbyists.name string

The name.

Covered Position
results.lobbying_representations.lobbyists.covered_position string

The covered position.

Get recent official communications

This action gets lists of official communications to Congress from the president, executive branch agencies and state legislatures to congressional committees.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Communication ID
results.communication_id string

The unique identifier of the communication.

URL
results.url string

The URL address.

Date
results.date string

The date.

Text
results.text string

The text.

Category
results.category string

The category.

Congress
results.congress integer

The Congressional session.

Chamber
results.chamber string

The chamber.

Requirement Number
results.requirement_number string

The requirement number.

Requirement URL
results.requirement_url string

The URL address of the requirement.

Committee Code
results.committee_code string

The committee code.

Committee Name
results.committee_name string

The name of the committee.

Get recent official communications by category

This action gets lists of official communications to Congress in a specific category. It returns the 20 most recent results for the specified type: ec (Executive Communication), pm (Presidential Message) or pom (Petition or Memorial).

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Category
category True string

The category.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Category
category string

The category.

Offset
offset integer

The pagination number offset.

Results
results array of object
ID
results.id string

The unique identifier.

URL
results.url string

The URL address.

Date
results.date string

The date.

Text
results.text string

The text.

Category
results.category string

The category.

Congress
results.congress integer

The Congressional session.

Chamber
results.chamber string

The chamber.

Requirement Number
results.requirement_number string

The requirement number.

Requirement URL
results.requirement_url string

The URL address of the requirement.

Committee Code
results.committee_code string

The committee code.

Committee Name
results.committee_name string

The name of the committee.

Get recent official communications by date

This action gets lists of official communications to Congress on a specific date.

Parameters

Name Key Required Type Description
Date
date True string

The date in YYYY-MM-dd format.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Date
date string

The date.

Offset
offset integer

The pagination number offset.

Results
results array of object
ID
results.id string

The unique identifier.

URL
results.url string

The URL address.

Date
results.date string

The date.

Text
results.text string

The text.

Category
results.category string

The category.

Congress
results.congress integer

The Congressional session.

Chamber
results.chamber string

The chamber.

Requirement Number
results.requirement_number string

The requirement number.

Requirement URL
results.requirement_url string

The URL address of the requirement.

Committee Code
results.committee_code string

The committee code.

Committee Name
results.committee_name string

The name of the committee.

Get recent personal explanations

This actions gets lists of personal explanations. Lawmakers, mostly in the House but also in the Senate, can make personal explanations for missed or mistaken votes in the Congressional Record. These explanations can refer to a single vote or to multiple votes.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Member
results.member string

The member.

API URI
results.api_uri string

The API Uri.

Name
results.name string

The name.

State
results.state string

The state.

Year
results.year integer

The year.

Roll Call
results.roll_call string

The Roll Call.

Party
results.party string

The party.

Date
results.date string

The date.

URL
results.url string

The URL address.

Text
results.text string

The text.

Category
results.category string

The category.

Parsed
results.parsed boolean

Whether parsed.

Vote API Uri
results.vote_api_uri string

The Uri of the vote API.

Get recent personal explanations by a specific member

This action gets recent personal explanations by a specific member.

Parameters

Name Key Required Type Description
Member ID
member_id True string

The unique identifier of the member.

Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Member ID
member_id string

The unique identifier of the member.

API URI
api_uri string

The Uri address of the API.

Name
name string

The name.

Congress
congress integer

The Congress session.

Results
results array of object
Date
results.date string

The date.

URL
results.url string

The URL address.

Text
results.text string

The text.

Get recent privately funded trips

This action gets a list of privately funded trips reported by all House members and staff in a particular Congress.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Congress
congress integer

The Congress session.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Member ID
results.member_id string

The member identifier.

API URI
results.api_uri string

The API Uri.

Display Name
results.display_name string

The display name.

Filing Type
results.filing_type string

The filing type.

Traveler
results.traveler string

The traveler.

Is Member
results.is_member integer

The number of members.

Departure Date
results.departure_date string

The departure date.

Return Date
results.return_date string

The return date.

Chamber
results.chamber string

The chamber.

Destination
results.destination string

The destination.

Sponsor
results.sponsor string

The sponsor.

Document ID
results.document_id string

The unique identifier of the document.

PDF URL
results.pdf_url string

The URL address of the PDF.

Get recent privately funded trips by a specific house member

This action gets a list of privately funded trips reported by a specific House member, including staff travel, in a particular Congress.

Parameters

Name Key Required Type Description
Member ID
member-id True string

The unique identifier of the member.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Member ID
member_id string

The unique identifier of the member.

API URI
api_uri string

The Uri address of the API.

Display Name
display_name string

The display name.

Results
results array of object
Filing Type
results.filing_type string

The filing type.

Traveler
results.traveler string

The traveler.

Is Member
results.is_member integer

The number of members.

Congress
results.congress integer

The Congressional session.

Departure Date
results.departure_date string

The departure date.

Return Date
results.return_date string

The return date.

Chamber
results.chamber string

The chamber.

Destination
results.destination string

The destination.

Sponsor
results.sponsor string

The sponsor.

Document ID
results.document_id string

The unique identifier of the document.

PDF URL
results.pdf_url string

The URL address of the PDF.

Get recent votes

This action returns recent votes from the House, Senate or both chambers. It returns the 20 most recent results, sorted by date and roll call number, and you can paginate through votes using the offset query string parameter that accepts multiples of 20.

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Chamber
results.chamber string

The chamber.

Offset
results.offset integer

The pagination number offset.

Number of Results
results.num_results integer

The number of results.

votes
results.votes array of object

votes

Congress
results.votes.congress integer

The Congress session.

Chamber
results.votes.chamber string

The chamber.

Session
results.votes.session integer

The session number.

Roll Call
results.votes.roll_call integer

The Roll Call number.

Source
results.votes.source string

The source.

URL
results.votes.url string

The URL address.

Vote Uri
results.votes.vote_uri string

The Uri address of the vote.

Number
results.votes.bill.number string

The number.

Bill ID
results.votes.bill.bill_id string

The unique identifier of the bill.

API URI
results.votes.bill.api_uri string

The Uri address of the API.

Title
results.votes.bill.title string

The title.

Latest Action
results.votes.bill.latest_action string

The latest action.

Question
results.votes.question string

The question.

Description
results.votes.description string

The description.

Vote Type
results.votes.vote_type string

The vote type.

Date
results.votes.date string

The date.

Time
results.votes.time string

The time.

Result
results.votes.result string

The result.

Yes
results.votes.democratic.yes integer

The Yes votes.

No
results.votes.democratic.no integer

The No votes.

Present
results.votes.democratic.present integer

The Present votes.

Not Voting
results.votes.democratic.not_voting integer

The Not Voting votes.

Majority Position
results.votes.democratic.majority_position string

The position of the majority.

Yes
results.votes.republican.yes integer

The Yes votes.

No
results.votes.republican.no integer

The No votes.

Present
results.votes.republican.present integer

The Present votes.

Not Voting
results.votes.republican.not_voting integer

The Not Voting votes.

Majority Position
results.votes.republican.majority_position string

The position of the majority.

Yes
results.votes.independent.yes integer

The Yes votes.

No
results.votes.independent.no integer

The No votes.

Present
results.votes.independent.present integer

The Present votes.

Not Voting
results.votes.independent.not_voting integer

The Not Voting votes.

Yes
results.votes.total.yes integer

The Yes votes.

No
results.votes.total.no integer

The No votes.

Present
results.votes.total.present integer

The Present votes.

Not Voting
results.votes.total.not_voting integer

The Not Voting votes.

This action gets Library of Congress-identified related bills for a particular bill. This request returns the 20 most recent results and supports paginated requests.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Bill ID
bill-id True string

A bill slug.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Congress
results.congress string

The Congressional session.

Bill ID
results.bill_id string

The unique identifier of the bill.

Bill Slug
results.bill_slug string

The bill slug.

Bill Type
results.bill_type string

The bill type.

Number
results.number string

The number.

Bill Uri
results.bill_uri string

The Uri address of the bill.

URL Number
results.url_number string

The number of URLs.

Title
results.title string

The title.

Sponsor Title
results.sponsor_title string

The sponsor title.

Sponsor ID
results.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.sponsor_name string

The name of the sponsor.

Sponsor State
results.sponsor_state string

The state of the sponsor.

Sponsor Party
results.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.sponsor_uri string

The Uri address of the sponsor.

Introduced Date
results.introduced_date string

The date introduced.

Number Of Cosponsors
results.number_of_cosponsors integer

The number of cosponsors.

Committees
results.committees string

The committees.

Latest Major Action Date
results.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.latest_major_action string

The latest major action.

House Passage Vote
results.house_passage_vote string

The House passage vote.

Senate Passage Vote
results.senate_passage_vote string

The Senate passage vote.

Related Bills
results.related_bills array of object
Number
results.related_bills.number string

The number.

Bill ID
results.related_bills.bill_id string

The unique identifier of the bill.

Bill Slug
results.related_bills.bill_slug string

The bill slug.

Bill Type
results.related_bills.bill_type string

The type of bill.

Title
results.related_bills.title string

The title.

Short Title
results.related_bills.short_title string

The short title.

Relationship
results.related_bills.relationship string

The relationship.

Sponsor Title
results.related_bills.sponsor_title string

The sponsor title.

Sponsor
results.related_bills.sponsor string

The sponsor.

Sponsor ID
results.related_bills.sponsor_id string

The unique identifier of the sponsor.

Sponsor Uri
results.related_bills.sponsor_uri string

The Uri of the sponsor.

Sponsor Party
results.related_bills.sponsor_party string

The party of the sponsor.

Sponsor State
results.related_bills.sponsor_state string

The state of the sponsor.

Introduced Date
results.related_bills.introduced_date string

The introduced date.

GPO PDF Uri
results.related_bills.gpo_pdf_uri string

The Uri of the GPO PDF.

Congress.gov URL
results.related_bills.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.related_bills.govtrack_url string

The Govtrack URL address.

Active
results.related_bills.active boolean

Whether active.

Last Vote
results.related_bills.last_vote string

The last vote.

House Passage
results.related_bills.house_passage string

The House passage.

Senate Passage
results.related_bills.senate_passage string

The Senate passage.

Enacted
results.related_bills.enacted string

The enacted.

Vetoed
results.related_bills.vetoed string

The vetoed.

Cosponsors
results.related_bills.cosponsors integer

The cosponsors.

Republicans
results.related_bills.cosponsors_by_party.R integer

The number of Republicans.

Democrats
results.related_bills.cosponsors_by_party.D integer

The number of Democrats.

Independents
results.related_bills.cosponsors_by_party.I integer

The number of Independents.

Committees
results.related_bills.committees string

The committees.

Committee Codes
results.related_bills.committee_codes array of string
Subcommittee Codes
results.related_bills.subcommittee_codes array of string
Primary Subject
results.related_bills.primary_subject string

The primary subject.

Summary
results.related_bills.summary string

The summary.

Short Summary
results.related_bills.summary_short string

The short summary.

Latest Major Action Date
results.related_bills.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.related_bills.latest_major_action string

The latest major action.

Get Senate nomination votes

This action gets Senate votes on presidential nominations. This request returns the 20 most recent results and supports paginated requests.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Total Votes
results.total_votes string

The total votes.

Offset
results.offset integer

The requested pagination offset.

Votes
results.votes array of object
Congress
results.votes.congress integer

The Congress session.

Chamber
results.votes.chamber string

The chamber.

Session
results.votes.session integer

The session.

Roll Call
results.votes.roll_call integer

The roll call.

Source
results.votes.source string

The source.

URL
results.votes.url string

The URL address.

Vote Uri
results.votes.vote_uri string

The vote Uri.

Question
results.votes.question string

The question.

Description
results.votes.title string

The description.

Vote Type
results.votes.vote_type string

The vote type.

Date
results.votes.date string

The date.

Time
results.votes.time string

The time.

Result
results.votes.result string

The result.

Nominee Uri
results.votes.nominee_uri string

The Uri address of the nominee.

Yes
results.votes.democratic.yes integer

The Yes votes.

No
results.votes.democratic.no integer

The No votes.

Present
results.votes.democratic.present integer

The Present votes.

Not Voting
results.votes.democratic.not_voting integer

The Not Voting number.

Majority Position
results.votes.democratic.majority_position string

The majority position.

Yes
results.votes.republican.yes integer

The Yes votes.

No
results.votes.republican.no integer

The No votes.

Present
results.votes.republican.present integer

The Present votes.

Not Voting
results.votes.republican.not_voting integer

The Not Voting number.

Majority Position
results.votes.republican.majority_position string

The majority position.

Yes
results.votes.independent.yes integer

The Yes votes.

No
results.votes.independent.no integer

The No votes.

Present
results.votes.independent.present integer

The Present votes.

Not Voting
results.votes.independent.not_voting integer

The Not Voting number.

Yes
results.votes.total.yes integer

The Yes votes.

No
results.votes.total.no integer

The No votes.

Present
results.votes.total.present integer

The Present votes.

Not Voting
results.votes.total.not_voting integer

The Not Voting number.

Margin
results.votes.total.margin integer

The margin number.

Get subjects for a specific bill

This action gets Library of Congress-assigned subjects about a particular bill. This request returns the 20 most recent results and supports paginated requests.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Bill ID
bill-id True string

A bill slug.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
num_results integer

The number of results.

Offset
offset integer

The pagination number offset.

Results
results array of object
Congress
results.congress string

The Congressional session.

Bill ID
results.bill_id string

The unique identifier of the bill.

Bill Slug
results.bill_slug string

The bill slug.

Bill Type
results.bill_type string

The bill type.

Number
results.number string

The number.

Bill Uri
results.bill_uri string

The Uri address of the bill.

URL Number
results.url_number string

The number of URLs.

Title
results.title string

The title.

Sponsor Title
results.sponsor_title string

The sponsor title.

Sponsor ID
results.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.sponsor_name string

The name of the sponsor.

Sponsor State
results.sponsor_state string

The state of the sponsor.

Sponsor Party
results.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.sponsor_uri string

The Uri address of the sponsor.

Introduced Date
results.introduced_date string

The date introduced.

Number Of Cosponsors
results.number_of_cosponsors integer

The number of cosponsors.

Committees
results.committees string

The committees.

Latest Major Action Date
results.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.latest_major_action string

The latest major action.

House Passage Vote
results.house_passage_vote string

The House passage vote.

Senate Passage Vote
results.senate_passage_vote string

The Senate passage vote.

Subjects
results.subjects array of object
Name
results.subjects.name string

The name.

URL Name
results.subjects.url_name string

The URL name.

Get upcoming bills

This action gets details on bills that may be considered by the House or Senate in the near future, based on scheduled published or announced by congressional leadership. The bills and their potential consideration are taken from the House Majority Leader and floor updates from Senate Republicans.

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Date
results.date string

The date.

Bills
results.bills array of object
Congress
results.bills.congress string

The Congress session.

Chamber
results.bills.chamber string

The chamber.

Bill ID
results.bills.bill_id string

The unique identifier of the bill.

Bill Slug
results.bills.bill_slug string

The bill slug.

Bill Type
results.bills.bill_type string

The type of bill.

Bill Number
results.bills.bill_number string

The bill number.

API URI
results.bills.api_uri string

The API Uri.

Legislative Day
results.bills.legislative_day string

The legislative day.

Scheduled At
results.bills.scheduled_at string

When scheduled at.

Range
results.bills.range string

The range.

Context
results.bills.context string

The context.

Description
results.bills.title string

The description.

Bill URL
results.bills.bill_url string

The URL address of the bill.

Consideration
results.bills.consideration string

The consideration.

Source Type
results.bills.source_type string

The source type.

URL
results.bills.url string

The URL address.

Get votes by date

This action gets all votes in a particular date range (fewer than 30 days).

Parameters

Name Key Required Type Description
Chamber
chamber True string

The chamber of Congress.

Start Date
start-date True string

The start date in YYYY-MM-DD format.

End Date
end-date True string

The end date in YYYY-MM-DD format.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Chamber
results.chamber string

The chamber.

Start Date
results.start_date string

The start date.

End Date
results.end_date string

The end date.

Number of Results
results.num_results integer

The number of results.

votes
results.votes array of object

votes

Congress
results.votes.congress integer

The Congress session.

Chamber
results.votes.chamber string

The chamber.

Session
results.votes.session integer

The session number.

Roll Call
results.votes.roll_call integer

The Roll Call number.

Source
results.votes.source string

The source.

URL
results.votes.url string

The URL address.

Vote Uri
results.votes.vote_uri string

The Uri address of the vote.

Bill ID
results.votes.bill.bill_id string

The unique identifier of the bill.

Number
results.votes.bill.number string

The number.

Sponsor ID
results.votes.bill.sponsor_id string

The unique identifier of the sponsor.

API URI
results.votes.bill.api_uri string

The Uri address of the API.

Title
results.votes.bill.title string

The title.

Latest Action
results.votes.bill.latest_action string

The latest action.

Nomination ID
results.votes.nomination.nomination_id string

The unique identifier of the nomination.

Number
results.votes.nomination.number string

The number.

Name
results.votes.nomination.name string

The name.

Agency
results.votes.nomination.agency string

The agency.

Question
results.votes.question string

The question.

Question Text
results.votes.question_text string

The text of the question.

Description
results.votes.description string

The description.

Vote Type
results.votes.vote_type string

The vote type.

Date
results.votes.date string

The date.

Time
results.votes.time string

The time.

Result
results.votes.result string

The result.

Yes
results.votes.democratic.yes integer

The Yes votes.

No
results.votes.democratic.no integer

The No votes.

Present
results.votes.democratic.present integer

The Present votes.

Not Voting
results.votes.democratic.not_voting integer

The Not Voting votes.

Majority Position
results.votes.democratic.majority_position string

The position of the majority.

Yes
results.votes.republican.yes integer

The Yes votes.

No
results.votes.republican.no integer

The No votes.

Present
results.votes.republican.present integer

The Present votes.

Not Voting
results.votes.republican.not_voting integer

The Not Voting votes.

Majority Position
results.votes.republican.majority_position string

The position of the majority.

Yes
results.votes.independent.yes integer

The Yes votes.

No
results.votes.independent.no integer

The No votes.

Present
results.votes.independent.present integer

The Present votes.

Not Voting
results.votes.independent.not_voting integer

The Not Voting votes.

Yes
results.votes.total.yes integer

The Yes votes.

No
results.votes.total.no integer

The No votes.

Present
results.votes.total.present integer

The Present votes.

Not Voting
results.votes.total.not_voting integer

The Not Voting votes.

Get votes by type

This action returns vote information in four categories: missed votes, party votes, lone no votes and perfect votes.

Parameters

Name Key Required Type Description
Congress
congress True string

The Congressional session number. Available sessions are 102-117 for House, 80-117 for Senate.

Chamber
chamber True string

The chamber of Congress.

Vote Type
vote-type True string

The type of vote.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Congress
results.congress string

The Congressional session.

Chamber
results.chamber string

The chamber.

Number of Results
results.num_results string

The number of results.

Offset
results.offset string

The requested pagination offset.

Members
results.members array of object
ID
results.members.id string

The unique identifier.

API URI
results.members.api_uri string

The API Uri.

Name
results.members.name string

The name.

Party
results.members.party string

The party affiliation.

State
results.members.state string

The state.

District
results.members.district string

The district.

Total Votes
results.members.total_votes string

The number of total votes.

Missed Votes
results.members.missed_votes string

The number of missed votes.

Missed Votes Percentage
results.members.missed_votes_pct number

The percentage of missed votes.

Rank
results.members.rank string

The rank.

Notes
results.members.notes string

The notes.

Search bills

This action searches the title and full text of legislation by keyword to get the 20 most recent bills. Searches cover House and Senate bills from the 113th Congress through the current Congress (117th). If multiple words are given (e.g. query=health care) the search is treated as multiple keywords using the OR operator. Quoting the words (e.g. query="health care") makes it a phrase search. Search results can be sorted by date (the default) or by relevance, and in ascending or descending order.

Parameters

Name Key Required Type Description
Query
query string

The keyword or phrase.

Sort
sort string

The sort method.

Direction
dir string

The sort direction.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Bills
results.bills array of object
Bill ID
results.bills.bill_id string

The unique identifier of the bill.

Bill Type
results.bills.bill_type string

The type of bill.

Number
results.bills.number string

The number.

Bill Uri
results.bills.bill_uri string

The Uri of the bill.

Title
results.bills.title string

The title.

Sponsor Title
results.bills.sponsor_title string

The sponsor title.

Sponsor ID
results.bills.sponsor_id string

The unique identifier of the sponsor.

Sponsor Name
results.bills.sponsor_name string

The name of the sponsor.

Sponsor State
results.bills.sponsor_state string

The state of the sponsor.

Sponsor Party
results.bills.sponsor_party string

The party of the sponsor.

Sponsor Uri
results.bills.sponsor_uri string

The Uri of the sponsor.

GPO PDF Uri
results.bills.gpo_pdf_uri string

The Uri of the GPO PDF.

Congress.gov URL
results.bills.congressdotgov_url string

The Congress.gov URL address.

Govtrack URL
results.bills.govtrack_url string

The Govtrack URL address.

Introduced Date
results.bills.introduced_date string

The introduced date.

Active
results.bills.active boolean

Whether active.

House Passage
results.bills.house_passage string

The House passage.

Senate Passage
results.bills.senate_passage string

The Senate passage.

Enacted
results.bills.enacted string

The enacted.

Vetoed
results.bills.vetoed string

The vetoed.

Cosponsors
results.bills.cosponsors integer

The cosponsors.

Committees
results.bills.committees string

The committees.

Committee Codes
results.bills.committee_codes array of string
Subcommittee Codes
results.bills.subcommittee_codes array of string
Primary Subject
results.bills.primary_subject string

The primary subject.

Summary
results.bills.summary string

The summary.

Short Summary
results.bills.summary_short string

The short summary.

Latest Major Action Date
results.bills.latest_major_action_date string

The date of the latest major action.

Latest Major Action
results.bills.latest_major_action string

The latest major action.

Search lobbying representation filings

This actions gets the 20 most recent lobbying representation filings for a given search term.

Parameters

Name Key Required Type Description
Query
query string

The keyword or phrase.

Offset
offset integer

The paging offset number.

Returns

Name Path Type Description
Status
status string

The response status.

Copyright
copyright string

The response copyright.

Results
results array of object
Number of Results
results.num_results integer

The number of results.

Offset
results.offset integer

The requested pagination offset.

Query
results.query string

The query.

Lobbying Representations
results.lobbying_representations array of object
Name
results.lobbying_representations.lobbying_client.name string

The name.

General Description
results.lobbying_representations.lobbying_client.general_description string

The general description.

Name
results.lobbying_representations.lobbying_registrant.name string

The name.

General Description
results.lobbying_representations.lobbying_registrant.general_description string

The general description.

In-house
results.lobbying_representations.inhouse string

The in-house.

Signed Date
results.lobbying_representations.signed_date string

The signed date.

Effective Date
results.lobbying_representations.effective_date string

The effective date.

XML Filename
results.lobbying_representations.xml_filename string

The XML filename.

ID
results.lobbying_representations.id string

The unique identifier.

Specific Issues
results.lobbying_representations.specific_issues array of string
Report Type
results.lobbying_representations.report_type string

The report type.

Report Year
results.lobbying_representations.report_year string

The report year.

Senate ID
results.lobbying_representations.senate_id string

The Senate unique identifier.

House ID
results.lobbying_representations.house_id string

The House unique identifier.

Lobbyists
results.lobbying_representations.lobbyists array of object
Name
results.lobbying_representations.lobbyists.name string

The name.

Covered Position
results.lobbying_representations.lobbyists.covered_position string

The covered position.