NAV
shell

Congress API Documentation

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 document describes the requests that users can make of the API and the responses that it returns.

Scope of data

The Congress API returns the following types of data:

Most of the data in the ProPublica Congress API is updated daily, while votes are updated every 30 minutes.

Data sources

The data returned by the Congress API is compiled from the following sources:

Certain fields in the API responses (such as party totals and vote agreement percentages) are calculated by ProPublica, based on these data sources. The data returned by the Congress API is subject to ProPublica's Data Terms of Use.

Authentication

To authorize, use this code:

# With shell, you can just pass the correct header with each request
curl "api_endpoint_here"
  -H "X-API-Key: PROPUBLICA_API_KEY"

Make sure to replace PROPUBLICA_API_KEY with your API key.

To use the Congress API, you must sign up for an API key. Usage is limited to 5000 requests per day (rate limits are subject to change). The API key must be included in all API requests to the server, as a header:

X-API-Key: PROPUBLICA_API_KEY

Requests

The Congress API uses a RESTful style. See individual methods below for permitted requests. The API only accepts GET requests. All requests begin with:

https://api.propublica.org/congress/{version}/

The current version is v1. For requests that have a congress parameter, the current Congress is 115.

Common Parameters

These parameters are used in all request types. See below for URI structures and additional parameters for each type of request.

The following parameters are optional:

Responses

The API provides JSON and XML responses for every type of request, and supports JSONP callbacks. Responses that are not date-based return the first 20 results; pagination is available via an offset query string parameter using multiples of 20 for most votes, nomination and bill requests that return more than one object.

Members

Lists of Members

curl "https://api.propublica.org/congress/v1/115/senate/members.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":" Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "congress": "115",
         "chamber": "Senate",
         "num_results": "101",
         "offset": "0",
         "members": [
              {
                 "id": "A000360",
                 "api_uri":"https://api.propublica.org/congress/v1/members/A000360.json",
                 "first_name": "Lamar",
                 "middle_name": "",
                 "last_name": "Alexander",
                 "party": "R",
                 "leadership_role": "",
                 "twitter_account": "SenAlexander",
                 "facebook_account": "senatorlamaralexander",
                 "govtrack_id": "300002",
                 "cspan_id": "5",
                 "votesmart_id": "",
                 "icpsr_id": "40304",
                 "crp_id": "",
                 "google_entity_id": "/m/01rbs3",
                 "url": "https://www.alexander.senate.gov/public/index.cfm/home",
                 "rss_url": "http://www.alexander.senate.gov/public/?a=RSS.Feed",
                 "domain": "",
                 "in_office": "true",
                 "dw_nominate": "",
                 "ideal_point": "",
                 "seniority": "15",
                 "next_election": "2020",
                 "total_votes": "82",
                 "missed_votes": "1",
                 "total_present": "0",
                 "ocd_id": "ocd-division/country:us/state:tn",
                 "office": "",
                 "phone": "202-224-4944",
                 "state": "TN",
                 "senate_class": "2",
                 "state_rank": "",
                 "lis_id": "S289"
                 ,"missed_votes_pct": "1.22",
                 "votes_with_party_pct": "98.77"
               },
                           {
                 "id": "B000575",
                 "api_uri":"https://api.propublica.org/congress/v1/members/B000575.json",
                 "first_name": "Roy",
                 "middle_name": "",
                 "last_name": "Blunt",
                 "party": "R",
                 "leadership_role": "",
                 "twitter_account": "RoyBlunt",
                 "facebook_account": "SenatorBlunt",
                 "govtrack_id": "400034",
                 "cspan_id": "45465",
                 "votesmart_id": "",
                 "icpsr_id": "29735",
                 "crp_id": "",
                 "google_entity_id": "/m/034fn4",
                 "url": "http://www.blunt.senate.gov/public",
                 "rss_url": "http://www.blunt.senate.gov/public/?a=RSS.Feed",
                 "domain": "",
                 "in_office": "true",
                 "dw_nominate": "",
                 "ideal_point": "",
                 "seniority": "7",
                 "next_election": "2022",
                 "total_votes": "82",
                 "missed_votes": "2",
                 "total_present": "0",
                 "ocd_id": "ocd-division/country:us/state:mo",
                 "office": "",
                 "phone": "202-224-5721",
                 "state": "MO",
                 "senate_class": "3",
                 "state_rank": "",
                 "lis_id": "S342"
                 ,"missed_votes_pct": "2.44",
                 "votes_with_party_pct": "98.75"
               },
                           {
                 "id": "W000817",
                 "api_uri":"https://api.propublica.org/congress/v1/members/W000817.json",
                 "first_name": "Elizabeth",
                 "middle_name": null,
                 "last_name": "Warren",
                 "party": "D",
                 "leadership_role": "",
                 "twitter_account": "SenWarren",
                 "facebook_account": "senatorelizabethwarren",
                 "govtrack_id": "412542",
                 "cspan_id": "1023023",
                 "votesmart_id": "",
                 "icpsr_id": "41301",
                 "crp_id": "",
                 "google_entity_id": "/m/01qh39",
                 "url": "http://www.warren.senate.gov",
                 "rss_url": "http://www.warren.senate.gov/rss/",
                 "domain": "www.warren.senate.gov",
                 "in_office": "true",
                 "dw_nominate": "",
                 "ideal_point": "",
                 "seniority": "5",
                 "next_election": "2018",
                 "total_votes": "82",
                 "missed_votes": "0",
                 "total_present": "0",
                 "ocd_id": "ocd-division/country:us/state:ma",
                 "office": "",
                 "phone": "202-224-4543",
                 "state": "MA",
                 "senate_class": "1",
                 "state_rank": "",
                 "lis_id": "S366"
                 ,"missed_votes_pct": "0.00",
                 "votes_with_party_pct": "93.90"
               },
                           {
                 "id": "Y000064",
                 "api_uri":"https://api.propublica.org/congress/v1/members/Y000064.json",
                 "first_name": "Todd",
                 "middle_name": null,
                 "last_name": "Young",
                 "party": "R",
                 "leadership_role": "",
                 "twitter_account": "SenToddYoung",
                 "facebook_account": "SenatorToddYoung",
                 "govtrack_id": "412428",
                 "cspan_id": "1033743",
                 "votesmart_id": "",
                 "icpsr_id": "21133",
                 "crp_id": "",
                 "google_entity_id": "/m/0ds030m",
                 "url": "https://www.young.senate.gov",
                 "rss_url": "",
                 "domain": "www.young.senate.gov",
                 "in_office": "true",
                 "dw_nominate": "",
                 "ideal_point": "",
                 "seniority": "1",
                 "next_election": "2022",
                 "total_votes": "82",
                 "missed_votes": "0",
                 "total_present": "0",
                 "ocd_id": "ocd-division/country:us/state:in",
                 "office": "",
                 "phone": "202-224-5623",
                 "state": "IN",
                 "senate_class": "3",
                 "state_rank": "",
                 "lis_id": "S391"
                 ,"missed_votes_pct": "0.00",
                 "votes_with_party_pct": "100.00"
               }
             ]
      }
   ]
}

To get a list of members of a particular chamber in a particular Congress, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/members.json

Query Parameters

Parameter Description
congress 102-115 for House, 80-115 for Senate
chamber house or senate

Get a Specific Member

curl " https://api.propublica.org/congress/v1/members/K000388.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":"Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "member_id": "K000388",
         "first_name": "Trent",
         "middle_name": "",
         "last_name": "Kelly",
         "date_of_birth": "1966-03-01",
         "gender": "M",
         "url": "https://trentkelly.house.gov",
         "times_topics_url": "",
         "times_tag": "",
         "govtrack_id": "412673",
         "cspan_id": "",
         "votesmart_id": "",
         "icpsr_id": "21561",
         "twitter_account": "reptrentkelly",
         "facebook_account": "reptrentkelly",
         "crp_id": "",
         "youtube_account": "",
         "google_entity_id": "/m/013b9qgh",
         "url": "https://trentkelly.house.gov",
         "rss_url": "",
         "domain": "",
         "in_office": "true",
         "current_party": "R",
         "most_recent_vote": "2016-06-07",
         "roles": [
 {
           "congress": "115",
           "chamber": "House",
           "title": "Representative",
           "state": "MS",
           "party": "R",
           "leadership_role": "",
           "fec_candidate_id": "H6MS01131",
           "seniority": "4",
           "district": "1",
           "ocd_id": "ocd-division/country:us/state:ms/cd:1",
           "start_date": "2017-01-03",
           "end_date": "2019-01-03",
           "office": "",
           "phone": "202-225-4306",
           "bills_sponsored": "1",
           "bills_cosponsored": "0",
           "missed_votes_pct": "0.00",
           "votes_with_party_pct": "97.66",
           "committees": [
           {
             "name": "Committee on Agriculture",
             "code": "HSAG",
             "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSAG.json",
             "rank_in_party": "20",
             "begin_date": "",
             "end_date": "2019-01-03"
           },
           {
             "name": "Committee on Armed Services",
             "code": "HSAS",
             "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSAS.json",
             "rank_in_party": "29",
             "begin_date": "",
             "end_date": "2019-01-03"
           },
           {
             "name": "Committee on Small Business",
             "code": "HSSM",
             "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSSM.json",
             "rank_in_party": "7",
             "begin_date": "",
             "end_date": "2019-01-03"
           }
           ]
         },
        {
           "congress": "114",
           "chamber": "House",
           "title": "Representative",
           "state": "MS",
           "party": "R",
           "leadership_role": "",
           "fec_candidate_id": "H6MS01131",
           "seniority": "2",
           "district": "1",
           "ocd_id": "ocd-division/country:us/state:ms/cd:1",
           "start_date": "2015-06-09",
           "end_date": "2017-01-03",
           "office": "",
           "phone": "",
           "bills_sponsored": "2",
           "bills_cosponsored": "79",
           "missed_votes_pct": "2.85",
           "votes_with_party_pct": "96.15",
           "committees": [
           {
             "name": "Committee on Agriculture",
             "code": "HSAG",
             "api_uri": "https://api.propublica.org/congress/v1/114/house/committees/HSAG.json",
             "rank_in_party": "26",
             "begin_date": "",
             "end_date": "2017-01-03"
           },
           {
             "name": "Committee on Small Business",
             "code": "HSSM",
             "api_uri": "https://api.propublica.org/congress/v1/114/house/committees/HSSM.json",
             "rank_in_party": "12",
             "begin_date": "",
             "end_date": "2017-01-03"
           }
           ]
         }
       ]
        }
    ]
}

To get biographical and Congressional role information for a particular member of Congress, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/members/{member-id}.json

URL Parameters

Parameter Description
member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.

Get New Members

curl "https://api.propublica.org/congress/v1/members/new.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":" Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "num_results": "20",
         "offset": "0",
         "members": [
              {
                 "id": "S001202",
                 "first_name": "Luther",
                 "middle_name": "",
                 "last_name": "Strange",
                 "party": "R",
                 "chamber": "Senate",
                 "state": "AL",
                 "start_date": "2017-02-09"
               },
                           {
                 "id": "F000466",
                 "first_name": "Brian",
                 "middle_name": "",
                 "last_name": "Fitzpatrick",
                 "party": "R",
                 "chamber": "House",
                 "state": "PA",
                 "district": "8",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "E000297",
                 "first_name": "Adriano",
                 "middle_name": "",
                 "last_name": "Espaillat",
                 "party": "D",
                 "chamber": "House",
                 "state": "NY",
                 "district": "13",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "S001201",
                 "first_name": "Thomas",
                 "middle_name": "",
                 "last_name": "Suozzi",
                 "party": "D",
                 "chamber": "House",
                 "state": "NY",
                 "district": "3",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "K000390",
                 "first_name": "Ruben",
                 "middle_name": "",
                 "last_name": "Kihuen",
                 "party": "D",
                 "chamber": "House",
                 "state": "NV",
                 "district": "4",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "R000608",
                 "first_name": "Jacky",
                 "middle_name": "",
                 "last_name": "Rosen",
                 "party": "D",
                 "chamber": "House",
                 "state": "NV",
                 "district": "3",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "G000583",
                 "first_name": "Josh",
                 "middle_name": "",
                 "last_name": "Gottheimer",
                 "party": "D",
                 "chamber": "House",
                 "state": "NJ",
                 "district": "5",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "B001298",
                 "first_name": "Don",
                 "middle_name": "",
                 "last_name": "Bacon",
                 "party": "R",
                 "chamber": "House",
                 "state": "NE",
                 "district": "2",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "B001305",
                 "first_name": "Ted",
                 "middle_name": "",
                 "last_name": "Budd",
                 "party": "R",
                 "chamber": "House",
                 "state": "NC",
                 "district": "13",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "L000587",
                 "first_name": "Jason",
                 "middle_name": "",
                 "last_name": "Lewis",
                 "party": "R",
                 "chamber": "House",
                 "state": "MN",
                 "district": "2",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "M001201",
                 "first_name": "Paul",
                 "middle_name": "",
                 "last_name": "Mitchell",
                 "party": "R",
                 "chamber": "House",
                 "state": "MI",
                 "district": "10",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "B001301",
                 "first_name": "Jack",
                 "middle_name": "",
                 "last_name": "Bergman",
                 "party": "R",
                 "chamber": "House",
                 "state": "MI",
                 "district": "1",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "R000606",
                 "first_name": "Jamie",
                 "middle_name": "",
                 "last_name": "Raskin",
                 "party": "D",
                 "chamber": "House",
                 "state": "MD",
                 "district": "8",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "B001304",
                 "first_name": "Anthony",
                 "middle_name": "",
                 "last_name": "Brown",
                 "party": "D",
                 "chamber": "House",
                 "state": "MD",
                 "district": "4",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "J000299",
                 "first_name": "Mike",
                 "middle_name": "",
                 "last_name": "Johnson",
                 "party": "R",
                 "chamber": "House",
                 "state": "LA",
                 "district": "4",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "F000464",
                 "first_name": "John",
                 "middle_name": "",
                 "last_name": "Faso",
                 "party": "R",
                 "chamber": "House",
                 "state": "NY",
                 "district": "19",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "T000478",
                 "first_name": "Claudia",
                 "middle_name": "",
                 "last_name": "Tenney",
                 "party": "R",
                 "chamber": "House",
                 "state": "NY",
                 "district": "22",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "G000582",
                 "first_name": "Jenniffer",
                 "middle_name": "",
                 "last_name": "González-Colón",
                 "party": "R",
                 "chamber": "House",
                 "state": "PR",
                 "district": "80",
                 "start_date": "2017-01-03"
               },
                           {
                 "id": "Y000064",
                 "first_name": "Todd",
                 "middle_name": "",
                 "last_name": "Young",
                 "party": "R",
                 "chamber": "Senate",
                 "state": "IN",

                 "start_date": "2017-01-03"
               },
                           {
                 "id": "V000128",
                 "first_name": "Chris",
                 "middle_name": "",
                 "last_name": "Van Hollen",
                 "party": "D",
                 "chamber": "Senate",
                 "state": "MD",

                 "start_date": "2017-01-03"
               }
             ]
      }
   ]
}

To get a list of the most recent new members of the current Congress, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/members/new.json

Get Current Members by State/District

curl "https://api.propublica.org/congress/v1/members/senate/RI/current.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2017 ProPublica Inc. All Rights Reserved.",
  "results": [
    {
      "id": "R000122",
      "name": "Jack Reed",
      "role": "Senator, 2nd Class",
      "gender": "M",
      "party": "D",
      "times_topics_url": "http://topics.nytimes.com/top/reference/timestopics/people/r/jack_reed/index.html",
      "twitter_id": "SenJackReed",
      "youtube_id": "SenatorReed",
      "seniority": "21",
      "next_election": "2020",
      "api_uri": "https://api.propublica.org/congress/v1/members/R000122.json"
    },
    {
      "id": "W000802",
      "name": "Sheldon Whitehouse",
      "role": "Senator, 1st Class",
      "gender": "M",
      "party": "D",
      "times_topics_url": "http://topics.nytimes.com/top/reference/timestopics/people/w/sheldon_whitehouse/index.html",
      "twitter_id": "SenWhitehouse",
      "youtube_id": "SenatorWhitehouse",
      "seniority": "11",
      "next_election": "2018",
      "api_uri": "https://api.propublica.org/congress/v1/members/W000802.json"
    }
  ]
}

To get biographical and Congressional role information for a particular member of Congress, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/members/{chamber}/{state}/current.json (Senate requests)

GET https://api.propublica.org/congress/v1/members/{chamber}/{state}/{district}/current.json (House requests)

URL Parameters

Parameter Description
chamber house or senate
state Two-letter state abbreviation
district House of Representatives district number (House requests only)

Get Members Leaving Office

curl "https://api.propublica.org/congress/v1/115/house/members/leaving.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":" Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "congress": "115",
         "chamber": "House",
         "num_results": "6",
         "offset": "0",
         "members": [
              {
                 "id": "Z000018",
                 "api_uri":"https://api.propublica.org/congress/v1/members/Z000018.json",
                 "first_name": "Ryan",
                 "middle_name": "",
                 "last_name": "Zinke",
                 "party": "R",
                 "state": "MT",
                 "district": "1",
                 "begin_date": "2017-01-03",
                 "end_date": "2017-03-01",
                 "status": "Appointed to federal post",
                 "note": "Confirmed as Interior Secretary."
               },
                           {
                 "id": "M001182",
                 "api_uri":"https://api.propublica.org/congress/v1/members/M001182.json",
                 "first_name": "Mick",
                 "middle_name": "",
                 "last_name": "Mulvaney",
                 "party": "R",
                 "state": "SC",
                 "district": "5",
                 "begin_date": "2017-01-03",
                 "end_date": "2017-02-16",
                 "status": "Appointed to federal post",
                 "note": "Appointed OMB Director."
               },
                           {
                 "id": "P000591",
                 "api_uri":"https://api.propublica.org/congress/v1/members/P000591.json",
                 "first_name": "Tom",
                 "middle_name": "",
                 "last_name": "Price",
                 "party": "R",
                 "state": "GA",
                 "district": "6",
                 "begin_date": "2017-01-03",
                 "end_date": "2017-02-10",
                 "status": "Appointed to federal post",
                 "note": "Confirmed as Secretary of Health and Human Services."
               },
                           {
                 "id": "B000287",
                 "api_uri":"https://api.propublica.org/congress/v1/members/B000287.json",
                 "first_name": "Xavier",
                 "middle_name": "",
                 "last_name": "Becerra",
                 "party": "D",
                 "state": "CA",
                 "district": "34",
                 "begin_date": "2017-01-03",
                 "end_date": "2017-01-24",
                 "status": "Appointed to state or local post",
                 "note": "Resigned on Jan. 24, 2017 to become Attorney General of California."
               },
                           {
                 "id": "P000602",
                 "api_uri":"https://api.propublica.org/congress/v1/members/P000602.json",
                 "first_name": "Mike",
                 "middle_name": "",
                 "last_name": "Pompeo",
                 "party": "R",
                 "state": "KS",
                 "district": "4",
                 "begin_date": "2017-01-03",
                 "end_date": "2017-01-23",
                 "status": "Appointed to federal post",
                 "note": "Was confirmed as CIA director on Jan. 23, 2017."
               },
                           {
                 "id": "J000174",
                 "api_uri":"https://api.propublica.org/congress/v1/members/J000174.json",
                 "first_name": "Sam",
                 "middle_name": "",
                 "last_name": "Johnson",
                 "party": "R",
                 "state": "TX",
                 "district": "3",
                 "begin_date": "2017-01-03",
                 "end_date": "2019-01-03",
                 "status": "Retiring",
                 "note": "Announced retirement in email to supporters."
               }
             ]
      }
   ]
}

To get a list of members who have left the Senate or House or have announced plans to do so, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/members/leaving.json

Query Parameters

Parameter Description
congress 111-115
chamber house or senate

Get a Specific Member’s Vote Positions

curl "https://api.propublica.org/congress/v1/members/K000388/votes.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "results": [{
        "member_id": "K000388",
        "total_votes": "100",
        "offset": "0",
        "votes": [{
            "member_id": "K000388",
            "chamber": "House",
            "congress": "115",
            "session": "1",
            "roll_call": "139",
            "bill": {},
            "description": "Providing for consideration of H.R. 720, the Lawsuit Abuse Reduction Act of 2017; and providing for consideration of H.R. 985, the Fairness in Class Action Litigation Act of 2017",
            "question": "On Agreeing to the Resolution",
            "date": "2017-03-09",
            "time": "14:51:00",
            "position": "Yes"
        }, {
            "member_id": "K000388",
            "chamber": "House",
            "congress": "115",
            "session": "1",
            "roll_call": "138",
            "bill": {},
            "description": "Providing for consideration of H.R. 720, the Lawsuit Abuse Reduction Act of 2017; and providing for consideration of H.R. 985, the Fairness in Class Action Litigation Act of 2017",
            "question": "On Ordering the Previous Question",
            "date": "2017-03-09",
            "time": "14:42:00",
            "position": "Yes"
        }, {
            "member_id": "K000388",
            "chamber": "House",
            "congress": "115",
            "session": "1",
            "roll_call": "137",
            "bill": {},
            "description": "",
            "question": "On Motion to Adjourn",
            "date": "2017-03-08",
            "time": "17:45:00",
            "position": "Yes"
        }, {
            "member_id": "K000388",
            "chamber": "House",
            "congress": "115",
            "session": "1",
            "roll_call": "136",
            "bill": {
                "number": "H R 1301",
                "bill_uri": "https://api.propublica.org/congress/v1/115/bills/hr1301.json",
                "title": "Department of Defense Appropriations Act, 2017",
                "latest_action": "Motion to reconsider laid on the table Agreed to without objection."
            },
            "description": "Department of Defense Appropriations Act, 2017",
            "question": "On Passage",
            "date": "2017-03-08",
            "time": "17:19:00",
            "position": "Yes"
        }]
    }]
}

To get the most recent vote positions for a specific member of the House of Representatives or Senate, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/members/{member-id}/votes.json

URL Parameters

Parameter Description
member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.

Compare Two Members Vote Positions

curl " https://api.propublica.org/congress/v1/members/G000575/votes/D000624/114/house.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "first_member_id": "G000575",
      "first_member_api_uri": "https://api.propublica.org/congress/v1/members/G000575.json",
      "second_member_id": "D000624",
      "second_member_api_uri": "https://api.propublica.org/congress/v1/members/D000624.json",
      "congress": "114",
      "chamber": "House",
      "common_votes": "803",
      "disagree_votes": "129",
      "agree_percent": "83.94",
      "disagree_percent": "16.06"
    }
  ]
}

Use this request type to compare 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.

HTTP Request

GET https://api.propublica.org/congress/v1/members/{first-member-id}/votes/{second-member-id}/{congress}/{chamber}.json

URL Parameters

Parameter Description
first-member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
second-member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
congress 102-115 for House, 101-115 for Senate
chamber house or senate

Compare Two Members’ Bill Sponsorships

curl "https://api.propublica.org/congress/v1/members/B001283/bills/C001101/114/house.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":"Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "first_member_api_uri": "https://api.propublica.org/congress/v1/members/B001283.json",
         "second_member_api_uri": "https://api.propublica.org/congress/v1/members/C001101.json",
         "chamber": "House",
         "congress": "114",
         "common_bills": "15",
         "bills": [
          {
           "number": "H.R.1769",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1769.json",
           "title": "Toxic Exposure Research Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/B001271.json",
           "introduced_date": "2015-04-14",
           "cosponsors": "188",
           "committees": "House Veterans' Affairs Committee",
           "latest_major_action_date": "2016-02-25",
           "latest_major_action": "Ordered to be Reported in the Nature of a Substitute (Amended) by Voice Vote.",
           "first_member_date": "2015-09-08",
           "second_member_date": "2015-12-10"
          },
                  {
           "number": "H.R.969",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr969.json",
           "title": "Blue Water Navy Vietnam Veterans Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/G000564.json",
           "introduced_date": "2015-02-13",
           "cosponsors": "309",
           "committees": "House Veterans' Affairs Committee",
           "latest_major_action_date": "2015-03-06",
           "latest_major_action": "Referred to the Subcommittee on Disability Assistance and Memorial Affairs.",
           "first_member_date": "2015-02-13",
           "second_member_date": "2015-02-13"
          },
                  {
           "number": "H.R.699",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr699.json",
           "title": "Email Privacy Act",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/Y000063.json",
           "introduced_date": "2015-02-04",
           "cosponsors": "314",
           "committees": "House Judiciary Committee",
           "latest_major_action_date": "2015-12-01",
           "latest_major_action": "Committee Hearings Held.",
           "first_member_date": "2015-07-27",
           "second_member_date": "2015-02-04"
          },
                  {
           "number": "H.R.842",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr842.json",
           "title": "Huntington's Disease Parity Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/K000378.json",
           "introduced_date": "2015-02-10",
           "cosponsors": "245",
           "committees": "House Ways and Means Committee",
           "latest_major_action_date": "2015-02-10",
           "latest_major_action": "Referred to the House Committee on Ways and Means.",
           "first_member_date": "2015-04-21",
           "second_member_date": "2015-02-10"
          },
                  {
           "number": "H.R.1220",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1220.json",
           "title": "Removing Barriers to Colorectal Cancer Screening Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/D000604.json",
           "introduced_date": "2015-03-03",
           "cosponsors": "237",
           "committees": "House Energy and Commerce Committee",
           "latest_major_action_date": "2015-03-06",
           "latest_major_action": "Referred to the Subcommittee on Health.",
           "first_member_date": "2015-10-07",
           "second_member_date": "2015-07-28"
          },
                  {
           "number": "H.R.563",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr563.json",
           "title": "Honoring Our WWII Merchant Mariners Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/H001063.json",
           "introduced_date": "2015-01-27",
           "cosponsors": "66",
           "committees": "House Veterans' Affairs Committee",
           "latest_major_action_date": "2015-02-06",
           "latest_major_action": "Referred to the Subcommittee on Disability Assistance and Memorial Affairs.",
           "first_member_date": "2015-07-09",
           "second_member_date": "2016-03-21"
          },
                  {
           "number": "H.R.160",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr160.json",
           "title": "Protect Medical Innovation Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/P000594.json",
           "introduced_date": "2015-01-06",
           "cosponsors": "282",
           "committees": "House Ways and Means Committee",
           "latest_major_action_date": "2015-06-23",
           "latest_major_action": "Read the second time. Placed on Senate Legislative Calendar under General Orders. Calendar No. 125.",
           "first_member_date": "2015-01-06",
           "second_member_date": "2015-01-06"
          },
                  {
           "number": "H.R.1384",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1384.json",
           "title": "Honor America's Guard-Reserve Retirees Act",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/W000799.json",
           "introduced_date": "2015-03-16",
           "cosponsors": "132",
           "committees": "House Veterans' Affairs Committee",
           "latest_major_action_date": "2015-11-17",
           "latest_major_action": "Received in the Senate and Read twice and referred to the Committee on Veterans' Affairs.",
           "first_member_date": "2015-07-21",
           "second_member_date": "2015-06-08"
          },
                  {
           "number": "H.R.985",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr985.json",
           "title": "Concrete Masonry Products Research, Education, and Promotion Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/G000558.json",
           "introduced_date": "2015-02-13",
           "cosponsors": "244",
           "committees": "House Energy and Commerce Committee",
           "latest_major_action_date": "2015-07-29",
           "latest_major_action": "Ordered to be Reported (Amended) by Voice Vote.",
           "first_member_date": "2015-11-17",
           "second_member_date": "2015-03-17"
          },
                  {
           "number": "H.R.2567",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr2567.json",
           "title": "To posthumously award the Congressional Gold Medal to each of Glen Doherty, Tyrone Woods, J. Christopher Stevens, and Sean Smith in recognition of their contributions to the Nation.",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/Z000018.json",
           "introduced_date": "2015-05-21",
           "cosponsors": "59",
           "committees": "House Financial Services Committee",
           "latest_major_action_date": "2015-05-21",
           "latest_major_action": "Referred to the House Committee on Financial Services.",
           "first_member_date": "2015-05-21",
           "second_member_date": "2015-05-21"
          },
                  {
           "number": "H.R.1312",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1312.json",
           "title": "National Health Service Corps Improvement Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001159.json",
           "introduced_date": "2015-03-04",
           "cosponsors": "114",
           "committees": "House Energy and Commerce Committee",
           "latest_major_action_date": "2015-03-06",
           "latest_major_action": "Referred to the Subcommittee on Health.",
           "first_member_date": "2015-03-19",
           "second_member_date": "2015-07-22"
          },
                  {
           "number": "H.R.1100",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1100.json",
           "title": "Military Spouse Job Continuity Act of 2015",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/C001090.json",
           "introduced_date": "2015-02-26",
           "cosponsors": "143",
           "committees": "House Ways and Means Committee",
           "latest_major_action_date": "2015-02-26",
           "latest_major_action": "Referred to the House Committee on Ways and Means.",
           "first_member_date": "2015-07-23",
           "second_member_date": "2015-02-26"
          },
                  {
           "number": "H.R.1174",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hr1174.json",
           "title": "Law Enforcement Access to Data Stored Abroad Act",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001179.json",
           "introduced_date": "2015-02-27",
           "cosponsors": "136",
           "committees": "House Judiciary Committee",
           "latest_major_action_date": "2015-03-31",
           "latest_major_action": "Referred to the Subcommittee on Crime, Terrorism, Homeland Security, and Investigations.",
           "first_member_date": "2016-03-21",
           "second_member_date": "2015-06-08"
          },
                  {
           "number": "H.CON.RES.75",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hconres75.json",
           "title": "Expressing the sense of Congress that the atrocities perpetrated by ISIL against religious and ethnic minorities in Iraq and Syria include war crimes, crimes against humanity, and genocide.",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/F000449.json",
           "introduced_date": "2015-09-09",
           "cosponsors": "213",
           "committees": "House Foreign Relations Committee",
           "latest_major_action_date": "2016-03-15",
           "latest_major_action": "Received in the Senate and referred to the Committee on Foreign Relations.",
           "first_member_date": "2016-02-09",
           "second_member_date": "2015-10-09"
          },
                  {
           "number": "H.CON.RES.17",
           "api_uri": "https://api.propublica.org/congress/v1/114/bills/hconres17.json",
           "title": "Supporting the Local Radio Freedom Act.",
           "sponsor_uri": "https://api.propublica.org/congress/v1/members/C001062.json",
           "introduced_date": "2015-02-24",
           "cosponsors": "227",
           "committees": "House Judiciary Committee",
           "latest_major_action_date": "2015-03-17",
           "latest_major_action": "Referred to the Subcommittee on Courts, Intellectual Property, and the Internet.",
           "first_member_date": "2015-04-22",
           "second_member_date": "2016-02-25"
          }
        ]
      }
   ]
}

To compare bill sponsorship between two members who served in the same Congress and chamber, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/members/{first-member-id}/bills/{second-member-id}/{congress}/{chamber}.json

URL Parameters

Parameter Description
first-member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
second-member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
congress 102-115 for House, 101-115 for Senate
chamber house or senate

Get Bills Cosponsored by a Specific Member

curl "https://api.propublica.org/congress/v1/members/B001260/bills/cosponsored.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "id": "B001260",
      "member_uri": "https://api.propublica.org/congress/v1/members/B001260.json",
      "name": "Vern Buchanan",
      "num_results": "20",
      "offset": "0",
      "bills": [
        {
          "congress": "114",
          "number": "H.R.4722",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4722.json",
          "title": "Refundable Child Tax Credit Eligibility Verification Reform Act of 2016",
          "cosponsored_date": "2016-03-14",
          "sponsor_id": "J000174",
          "introduced_date": "2016-03-10",
          "cosponsors": "2",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2016-03-23",
          "latest_major_action": "Placed on the Union Calendar, Calendar No. 362."
        },
        {
          "congress": "114",
          "number": "H.R.2404",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2404.json",
          "title": "Treat and Reduce Obesity Act of 2015",
          "cosponsored_date": "2016-03-14",
          "sponsor_id": "P000594",
          "introduced_date": "2015-05-18",
          "cosponsors": "137",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-05-22",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.4717",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4717.json",
          "title": "MARTLAND Act",
          "cosponsored_date": "2016-03-07",
          "sponsor_id": "H001048",
          "introduced_date": "2016-03-07",
          "cosponsors": "12",
          "committees": "House Armed Services Committee",
          "latest_major_action_date": "2016-03-21",
          "latest_major_action": "Referred to the Subcommittee on Military Personnel."
        },
        {
          "congress": "114",
          "number": "H.R.605",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr605.json",
          "title": "Medicare Home Infusion Site of Care Act of 2015",
          "cosponsored_date": "2016-03-07",
          "sponsor_id": "E000179",
          "introduced_date": "2015-01-28",
          "cosponsors": "54",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-01-30",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.4667",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4667.json",
          "title": "To direct the Secretary of the Army to expedite the completion of repairs to the Herbert Hoover Dike, Florida, and for other purposes.",
          "cosponsored_date": "2016-03-02",
          "sponsor_id": "C001102",
          "introduced_date": "2016-03-02",
          "cosponsors": "4",
          "committees": "House Transportation and Infrastructure Committee",
          "latest_major_action_date": "2016-03-03",
          "latest_major_action": "Referred to the Subcommittee on Water Resources and Environment."
        },
        {
          "congress": "114",
          "number": "H.R.3080",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3080.json",
          "title": "Tribal Employment and Jobs Protection Act",
          "cosponsored_date": "2016-02-26",
          "sponsor_id": "N000184",
          "introduced_date": "2015-07-15",
          "cosponsors": "24",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-07-15",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.3719",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3719.json",
          "title": "STOP ABUSE Act of 2015",
          "cosponsored_date": "2016-02-25",
          "sponsor_id": "G000570",
          "introduced_date": "2015-10-08",
          "cosponsors": "8",
          "committees": "House Judiciary Committee",
          "latest_major_action_date": "2015-11-03",
          "latest_major_action": "Referred to the Subcommittee on Crime, Terrorism, Homeland Security, and Investigations."
        },
        {
          "congress": "114",
          "number": "H.R.953",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr953.json",
          "title": "Comprehensive Addiction and Recovery Act of 2015",
          "cosponsored_date": "2016-02-24",
          "sponsor_id": "S000244",
          "introduced_date": "2015-02-12",
          "cosponsors": "112",
          "committees": "House Education and the Workforce Committee",
          "latest_major_action_date": "2015-04-29",
          "latest_major_action": "Referred to the Subcommittee on Higher Education and Workforce Training."
        },
        {
          "congress": "114",
          "number": "H.R.4247",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4247.json",
          "title": "Cuban Immigrant Work Opportunity Act of 2015",
          "cosponsored_date": "2016-02-23",
          "sponsor_id": "C001107",
          "introduced_date": "2015-12-15",
          "cosponsors": "34",
          "committees": "House Education and the Workforce Committee",
          "latest_major_action_date": "2016-03-23",
          "latest_major_action": "Referred to the Subcommittee on Higher Education and Workforce Training."
        },
        {
          "congress": "114",
          "number": "H.R.1475",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr1475.json",
          "title": "Korean War Veterans Memorial Wall of Remembrance Act of 2015",
          "cosponsored_date": "2016-02-23",
          "sponsor_id": "J000174",
          "introduced_date": "2015-03-19",
          "cosponsors": "309",
          "committees": "House Natural Resources Committee",
          "latest_major_action_date": "2016-02-25",
          "latest_major_action": "Received in the Senate."
        },
        {
          "congress": "114",
          "number": "H.R.546",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr546.json",
          "title": "ACE Kids Act of 2015",
          "cosponsored_date": "2016-02-23",
          "sponsor_id": "B000213",
          "introduced_date": "2015-01-27",
          "cosponsors": "196",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-01-30",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.2711",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2711.json",
          "title": "No Subsidies Without Verification Act of 2015",
          "cosponsored_date": "2016-02-23",
          "sponsor_id": "B001273",
          "introduced_date": "2015-06-10",
          "cosponsors": "15",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-06-12",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.814",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr814.json",
          "title": "Thin Blue Line Act",
          "cosponsored_date": "2016-02-12",
          "sponsor_id": "J000296",
          "introduced_date": "2015-02-09",
          "cosponsors": "45",
          "committees": "House Judiciary Committee",
          "latest_major_action_date": "2015-03-16",
          "latest_major_action": "Referred to the Subcommittee on Crime, Terrorism, Homeland Security, and Investigations."
        },
        {
          "congress": "114",
          "number": "H.R.921",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr921.json",
          "title": "Sports Medicine Licensure Clarity Act of 2015",
          "cosponsored_date": "2016-02-10",
          "sponsor_id": "G000558",
          "introduced_date": "2015-02-12",
          "cosponsors": "121",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-02-13",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.4521",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4521.json",
          "title": "Lake Berryessa Recreation Enhancement Act of 2016",
          "cosponsored_date": "2016-02-10",
          "sponsor_id": "T000460",
          "introduced_date": "2016-02-10",
          "cosponsors": "178",
          "committees": "House Natural Resources Committee",
          "latest_major_action_date": "2016-02-16",
          "latest_major_action": "Referred to the Subcommittee on Water, Power and Oceans."
        },
        {
          "congress": "114",
          "number": "H.R.4446",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4446.json",
          "title": "Zika Response and Safety Act of 2016",
          "cosponsored_date": "2016-02-10",
          "sponsor_id": "S001192",
          "introduced_date": "2016-02-03",
          "cosponsors": "9",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2016-02-05",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.R.1147",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr1147.json",
          "title": "Legal Workforce Act",
          "cosponsored_date": "2016-02-08",
          "sponsor_id": "S000583",
          "introduced_date": "2015-02-27",
          "cosponsors": "45",
          "committees": "House Judiciary Committee",
          "latest_major_action_date": "2015-03-03",
          "latest_major_action": "Ordered to be Reported by the Yeas and Nays: 20 - 13."
        },
        {
          "congress": "114",
          "number": "H.R.4126",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4126.json",
          "title": "Guantanamo Transfer Prevention Act",
          "cosponsored_date": "2016-02-01",
          "sponsor_id": "Y000065",
          "introduced_date": "2015-11-19",
          "cosponsors": "70",
          "committees": "House Armed Services Committee",
          "latest_major_action_date": "2015-11-19",
          "latest_major_action": "Referred to the House Committee on Armed Services."
        },
        {
          "congress": "114",
          "number": "H.R.3953",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3953.json",
          "title": "To designate the facility of the United States Postal Service located at 4122 Madison Street, Elfers, Florida, as the 'Private First Class Felton Roger Fussell Memorial Post Office'.",
          "cosponsored_date": "2016-01-13",
          "sponsor_id": "B001257",
          "introduced_date": "2015-11-05",
          "cosponsors": "18",
          "committees": "House Oversight and Government Reform Committee",
          "latest_major_action_date": "2015-11-05",
          "latest_major_action": "Referred to the House Committee on Oversight and Government Reform."
        },
        {
          "congress": "114",
          "number": "H.R.4343",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4343.json",
          "title": "Bikeshare Transit Act of 2016",
          "cosponsored_date": "2016-01-07",
          "sponsor_id": "B000574",
          "introduced_date": "2016-01-07",
          "cosponsors": "1",
          "committees": "House Transportation and Infrastructure Committee",
          "latest_major_action_date": "2016-01-08",
          "latest_major_action": "Referred to the Subcommittee on Highways and Transit."
        }
      ]
    }
  ]
}

To get the 20 most recent bill cosponsorships for a particular member, either bills cosponsored or bills where cosponsorship was withdrawn:

HTTP Request

GET https://api.propublica.org/congress/v1/members/{member-id}/bills/{type}.json

URL Parameters

Parameter Description
member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
type cosponsored or withdrawn

Votes

Get a Specific Roll Call Vote

curl "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/17.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this (House votes do not have the tie_breaker and tie_breaker_vote attributes, as these can only occur on Senate votes):

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "results": {
        "votes": {
            "vote": {
                "congress": "115",
                "session": "1",
                "chamber": "Senate",
                "roll_call": "17",
                "source": "http://senate.gov/legislative/LIS/roll_call_votes/vote1151/vote_115_1_00017.xml",
                "url": "http://www.senate.gov/legislative/LIS/roll_call_lists/roll_call_vote_cfm.cfm?congress=115&session=1&vote=00017",
                "bill": {
                    "bill_id": "sconres3-115",
                    "api_uri": "https://api.propublica.org/congress/v1/115/bills/sconres3.json",
                    "title": "A concurrent resolution setting forth the congressional budget for the United States Government for fiscal year 2017 and setting forth the appropriate budgetary levels for fiscal years 2018 through 2026.",
                    "latest_action": "Motion to reconsider laid on the table Agreed to without objection."
                },
                "question": "On the Motion",
                "description": "To establish a deficit-neutral reserve fund relating to reforming housing and Medicaid without prioritizing able-bodied adults over the disabled or raiding the Medicare Trust Funds to pay for new government programs, like Obamacare, which has failed Americans by increasing premiums and reducing affordable health care opportunities.",
                "vote_type": "3/5",
                "date": "2017-01-11",
                "time": "22:07:00",
                "result": "Motion Rejected",
                "tie_breaker": "",
                "tie_breaker_vote": "",
                "democratic": {
                    "yes": "0",
                    "no": "45",
                    "present": "0",
                    "not_voting": "1",
                    "majority_position": "No"
                },
                "republican": {
                    "yes": "51",
                    "no": "0",
                    "present": "0",
                    "not_voting": "1",
                    "majority_position": "Yes"
                },
                "independent": {
                    "yes": "0",
                    "no": "2",
                    "present": "0",
                    "not_voting": "0"
                },
                "total": {
                    "yes": "51",
                    "no": "47",
                    "present": "0",
                    "not_voting": "2"
                },
                "positions": [{
                    "member_id": "A000360",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001230",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001261",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001267",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001277",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "B000575",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001288",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001236",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "B000944",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "B001135",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C000127",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001047",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C000141",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C000174",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001070",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001075",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C000567",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001035",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001088",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001071",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001056",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001113",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001095",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C000880",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "C001098",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "D000618",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "D000607",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "D000622",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "D000563",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "E000285",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "E000295",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "F000062",
                    "vote_position": "Not Voting",
                    "dw_nominate": ""
                }, {
                    "member_id": "F000463",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "F000444",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "F000457",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "G000562",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "G000555",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "G000359",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "G000386",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001075",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001076",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "H000338",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001046",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001069",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001041",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001042",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "H001061",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "I000024",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "I000055",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "J000293",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "K000384",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "K000393",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "K000383",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "K000367",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "L000575",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "L000174",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "L000577",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001183",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M000133",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M000303",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001170",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M000355",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "M000639",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001176",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M000934",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001153",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001169",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "M001111",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "N000032",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "P000603",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "P000612",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "P000595",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "P000449",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "R000122",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "R000584",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "R000307",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "R000605",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "R000595",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "S000033",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001197",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001194",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "S000148",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001184",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001141",
                    "vote_position": "Not Voting",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001181",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "S000320",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "S000770",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "S001198",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "T000464",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "T000250",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "T000476",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "T000461",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "U000039",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "V000128",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "W000805",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "W000817",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "W000802",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "W000437",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }, {
                    "member_id": "W000779",
                    "vote_position": "No",
                    "dw_nominate": ""
                }, {
                    "member_id": "Y000064",
                    "vote_position": "Yes",
                    "dw_nominate": ""
                }]
            },

            "vacant_seats": []
        }
    }
}

To get a specific roll-call vote, including a complete list of member positions, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/sessions/{session-number}/votes/{roll-call-number}.json

URL Parameters

Parameter Description
congress 102-115 for House, 101-115 for Senate
chamber house or senate
session-number 1 or 2, depending on year (1 is odd-numbered years, 2 is even-numbered years)
roll-call-number integer

Get Votes by Type

curl "https://api.propublica.org/congress/v1/114/house/votes/missed.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "congress": "114",
      "chamber": "House",
      "num_results": "445",
      "offset": "0",
      "members": [
        {
          "id": "S000510",
          "name": "Adam Smith",
          "party": "D",
          "state": "WA",
          "district": "9",
          "total_votes": "759",
          "missed_votes": "181",
          "missed_votes_pct": "23.85",
          "rank": "1",
          "notes": ""
        },
        {
          "id": "H000636",
          "name": "Rubén Hinojosa",
          "party": "D",
          "state": "TX",
          "district": "15",
          "total_votes": "759",
          "missed_votes": "177",
          "missed_votes_pct": "23.32",
          "rank": "2",
          "notes": "Announced retirement on Nov. 13, 2015."
        },
        {
          "id": "P000604",
          "name": "Donald M. Payne Jr.",
          "party": "D",
          "state": "NJ",
          "district": "10",
          "total_votes": "759",
          "missed_votes": "164",
          "missed_votes_pct": "21.61",
          "rank": "3",
          "notes": ""
        },
        {
          "id": "R000515",
          "name": "Bobby L. Rush",
          "party": "D",
          "state": "IL",
          "district": "1",
          "total_votes": "759",
          "missed_votes": "148",
          "missed_votes_pct": "19.50",
          "rank": "4",
          "notes": ""
        },
        {
          "id": "S000030",
          "name": "Loretta Sánchez",
          "party": "D",
          "state": "CA",
          "district": "46",
          "total_votes": "759",
          "missed_votes": "147",
          "missed_votes_pct": "19.37",
          "rank": "5",
          "notes": "Running for Senate."
        },
        {
          "id": "M001137",
          "name": "Gregory W. Meeks",
          "party": "D",
          "state": "NY",
          "district": "5",
          "total_votes": "754",
          "missed_votes": "121",
          "missed_votes_pct": "16.05",
          "rank": "6",
          "notes": ""
        },
        {
          "id": "T000473",
          "name": "Mark Takai",
          "party": "D",
          "state": "HI",
          "district": "1",
          "total_votes": "759",
          "missed_votes": "118",
          "missed_votes_pct": "15.55",
          "rank": "7",
          "notes": ""
        },
        {
          "id": "C001061",
          "name": "Emanuel Cleaver II",
          "party": "D",
          "state": "MO",
          "district": "5",
          "total_votes": "759",
          "missed_votes": "117",
          "missed_votes_pct": "15.42",
          "rank": "8",
          "notes": ""
        },
        {
          "id": "G000535",
          "name": "Luis V. Gutiérrez",
          "party": "D",
          "state": "IL",
          "district": "4",
          "total_votes": "759",
          "missed_votes": "112",
          "missed_votes_pct": "14.76",
          "rank": "9",
          "notes": ""
        },
        {
          "id": "R000582",
          "name": "Phil Roe",
          "party": "R",
          "state": "TN",
          "district": "1",
          "total_votes": "759",
          "missed_votes": "108",
          "missed_votes_pct": "14.23",
          "rank": "10",
          "notes": "Pamela Roe, the wife of Mr. Roe, died on March 5, 2015."
        },
        {
          "id": "J000032",
          "name": "Sheila Jackson-Lee",
          "party": "D",
          "state": "TX",
          "district": "18",
          "total_votes": "759",
          "missed_votes": "100",
          "missed_votes_pct": "13.18",
          "rank": "11",
          "notes": ""
        },
        {
          "id": "F000458",
          "name": "Stephen Fincher",
          "party": "R",
          "state": "TN",
          "district": "8",
          "total_votes": "759",
          "missed_votes": "99",
          "missed_votes_pct": "13.04",
          "rank": "12",
          "notes": "Announced retirement on Feb. 1, 2016."
        },
        ...
        {
          "id": "Y000066",
          "name": "David Young",
          "party": "R",
          "state": "IA",
          "district": "3",
          "total_votes": "759",
          "missed_votes": "0",
          "missed_votes_pct": "0.00",
          "rank": "434",
          "notes": ""
        },
        {
          "id": "L000585",
          "name": "Darin M. LaHood",
          "party": "R",
          "state": "IL",
          "district": "18",
          "total_votes": "263",
          "missed_votes": "0",
          "missed_votes_pct": "0.00",
          "rank": "435",
          "notes": ""
        }
      ]
    }
  ]
}

You can get vote information in four categories: missed votes, party votes, lone no votes and perfect votes. Missed votes provides information about the voting attendance of each member of a specific chamber and congress. Party votes provides information about how often each member of a specific chamber and congress votes with a majority of his or her party. Lone no votes provides information lists members in a specific chamber and congress who were the only members to vote No on a roll call vote, and how often that happened. Perfect votes lists members in a specific chamber and congress who voted Yes or No on every vote for which he or she was eligible.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/votes/{vote-type}.json

URL Parameters

Parameter Description
congress 102-115 for House, 101-115 for Senate
chamber house or senate
vote-type missed, party, loneno or perfect

Get Votes by Date

curl "https://api.propublica.org/congress/v1/senate/votes/2017/01.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "results": {
        "chamber": "Senate",
        "year": "2017",
        "month": "Jan.",
        "num_results": "35",
        "votes": [{
            "congress": "115",
            "session": "1",
            "roll_call": "35",
            "source": "http://senate.gov/legislative/LIS/roll_call_votes/vote1151/vote_115_1_00035.xml",
            "url": "http://www.senate.gov/legislative/LIS/roll_call_lists/roll_call_vote_cfm.cfm?congress=115&session=1&vote=00035",
            "vote_uri": "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/35.json",
            "nomination": {
                "nomination_id": "PN35-115",
                "number": "PN35",
                "name": "Elaine L. Chao",
                "agency": "Department of Transportation"
            },
            "question": "On the Nomination",
            "description": "Elaine L. Chao, of Kentucky, to be Secretary of Transportation",
            "vote_type": "1/2",
            "date": "2017-01-31",
            "time": "12:33:00",
            "result": "Nomination Confirmed",
            "democratic": {
                "yes": "41",
                "no": "5",
                "present": "0",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "republican": {
                "yes": "51",
                "no": "0",
                "present": "1",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "independent": {
                "yes": "1",
                "no": "1",
                "present": "0",
                "not_voting": "0"
            },
            "total": {
                "yes": "93",
                "no": "6",
                "present": "1",
                "not_voting": "0"
            }
        }, {
            "congress": "115",
            "session": "1",
            "roll_call": "34",
            "source": "http://senate.gov/legislative/LIS/roll_call_votes/vote1151/vote_115_1_00034.xml",
            "url": "http://www.senate.gov/legislative/LIS/roll_call_lists/roll_call_vote_cfm.cfm?congress=115&session=1&vote=00034",
            "vote_uri": "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/34.json",
            "nomination": {
                "nomination_id": "PN25-115",
                "number": "PN25",
                "name": "Rex W. Tillerson",
                "agency": "Department of State"
            },
            "question": "On the Cloture Motion",
            "description": "Rex W. Tillerson, of Texas, to be Secretary of State",
            "vote_type": "1/2",
            "date": "2017-01-30",
            "time": "17:25:00",
            "result": "Cloture Motion Agreed to",
            "democratic": {
                "yes": "3",
                "no": "42",
                "present": "0",
                "not_voting": "1",
                "majority_position": "No"
            },
            "republican": {
                "yes": "52",
                "no": "0",
                "present": "0",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "independent": {
                "yes": "1",
                "no": "1",
                "present": "0",
                "not_voting": "0"
            },
            "total": {
                "yes": "56",
                "no": "43",
                "present": "0",
                "not_voting": "1"
            }
        }, {
            "congress": "115",
            "session": "1",
            "roll_call": "33",
            "source": "http://senate.gov/legislative/LIS/roll_call_votes/vote1151/vote_115_1_00033.xml",
            "url": "http://www.senate.gov/legislative/LIS/roll_call_lists/roll_call_vote_cfm.cfm?congress=115&session=1&vote=00033",
            "vote_uri": "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/33.json",
            "nomination": {
                "nomination_id": "PN50-115",
                "number": "PN50",
                "name": "Nikki R. Haley",
                "agency": "Department of State"
            },
            "question": "On the Nomination",
            "description": "Nikki R. Haley, of South Carolina, to be Representative of the United States of America to the Sessions of the General Assembly of the United Nations during her tenure of service as Representative of the United States of America to the United Nations; and Nikki R. Haley, of South Carolina, to be the Representative of the United States of America to the United Nations, with the rank and status of Ambassador, and the Representative of the United States of America in the Security Council of the United Nations",
            "vote_type": "1/2",
            "date": "2017-01-24",
            "time": "17:31:00",
            "result": "Nomination Confirmed",
            "democratic": {
                "yes": "43",
                "no": "3",
                "present": "0",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "republican": {
                "yes": "52",
                "no": "0",
                "present": "0",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "independent": {
                "yes": "1",
                "no": "1",
                "present": "0",
                "not_voting": "0"
            },
            "total": {
                "yes": "96",
                "no": "4",
                "present": "0",
                "not_voting": "0"
            }
        }, {
            "congress": "115",
            "session": "1",
            "roll_call": "32",
            "source": "http://senate.gov/legislative/LIS/roll_call_votes/vote1151/vote_115_1_00032.xml",
            "url": "http://www.senate.gov/legislative/LIS/roll_call_lists/roll_call_vote_cfm.cfm?congress=115&session=1&vote=00032",
            "vote_uri": "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/32.json",
            "nomination": {
                "nomination_id": "PN43-115",
                "number": "PN43",
                "name": "Mike Pompeo",
                "agency": "Central Intelligence Agency"
            },
            "question": "On the Nomination",
            "description": "Mike Pompeo, of Kansas, to be Director of the Central Intelligence Agency",
            "vote_type": "1/2",
            "date": "2017-01-23",
            "time": "19:01:00",
            "result": "Nomination Confirmed",
            "democratic": {
                "yes": "14",
                "no": "30",
                "present": "0",
                "not_voting": "2",
                "majority_position": "No"
            },
            "republican": {
                "yes": "51",
                "no": "1",
                "present": "0",
                "not_voting": "0",
                "majority_position": "Yes"
            },
            "independent": {
                "yes": "1",
                "no": "1",
                "present": "0",
                "not_voting": "0"
            },
            "total": {
                "yes": "66",
                "no": "32",
                "present": "0",
                "not_voting": "2"
            }
        }]
    }
}

You can get all votes in a particular month, or all votes in a particular date range (fewer than 30 days). This request type has two URI structures. Either use a year and month combination or a range of two dates, which cannot exceed 30 days.

HTTP Request

GET https://api.propublica.org/congress/v1/{chamber}/votes/{year}/{month}.json

URL Parameters

For year and month requests:

Parameter Description
chamber house or senate
year YYYY format
month MM format

For date range requests:

Parameter Description
chamber house or senate
start-date YYYY-MM-DD format
end-date YYYY-MM-DD format

Get Senate Nomination Votes

curl "https://api.propublica.org/congress/v1/114/nominations.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this (House votes do not have the tie_breaker and tie_breaker_vote attributes, as these can only occur on Senate votes):

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "total_votes": "37",
      "offset": "0",
      "votes": [
        {
          "congress": "114",
          "session": "2",
          "roll_call": "36",
          "question": "On the Nomination",
          "description": "John B. King, of New York, to be Secretary of Education",
          "vote_type": "1/2",
          "date": "2016-03-14",
          "time": "17:34:00",
          "result": "Nomination Confirmed",
          "tie_breaker": "",
          "tie_breaker_vote": "",
          "nominee_uri": "https://api.propublica.org/congress/v1/114/nominees/PN1152.json",
          "democratic": {
            "yes": "41",
            "no": "1",
            "present": "0",
            "not_voting": "2",
            "majority_position": "Yes"
          },
          "republican": {
            "yes": "7",
            "no": "39",
            "present": "0",
            "not_voting": "8",
            "majority_position": "No"
          },
          "independent": {
            "yes": "1",
            "no": "0",
            "present": "0",
            "not_voting": "1"
          },
          "total": {
            "yes": "49",
            "no": "40",
            "present": "0",
            "not_voting": "11",
            "margin": "9"
          }
        },
        {
          "congress": "114",
          "session": "2",
          "roll_call": "25",
          "question": "On the Nomination",
          "description": "Robert McKinnon Califf, of South Carolina, to be Commissioner of Food and Drugs, Department of Health and Human Services",
          "vote_type": "1/2",
          "date": "2016-02-24",
          "time": "12:03:00",
          "result": "Nomination Confirmed",
          "tie_breaker": "",
          "tie_breaker_vote": "",
          "nominee_uri": "https://api.propublica.org/congress/v1/114/nominees/PN849.json",
          "democratic": {
            "yes": "39",
            "no": "3",
            "present": "0",
            "not_voting": "2",
            "majority_position": "Yes"
          },
          "republican": {
            "yes": "49",
            "no": "1",
            "present": "0",
            "not_voting": "4",
            "majority_position": "Yes"
          },
          "independent": {
            "yes": "1",
            "no": "0",
            "present": "0",
            "not_voting": "1"
          },
          "total": {
            "yes": "89",
            "no": "4",
            "present": "0",
            "not_voting": "7",
            "margin": "85"
          }
        },
        {
          "congress": "114",
          "session": "2",
          "roll_call": "23",
          "question": "On the Nomination",
          "description": "Leonard Terry Strand, of South Dakota, to be United States District Judge for the Northern District of Iowa",
          "vote_type": "1/2",
          "date": "2016-02-11",
          "time": "13:43:00",
          "result": "Nomination Confirmed",
          "tie_breaker": "",
          "tie_breaker_vote": "",
          "nominee_uri": "https://api.propublica.org/congress/v1/114/nominees/PN675.json",
          "democratic": {
            "yes": "43",
            "no": "0",
            "present": "0",
            "not_voting": "1",
            "majority_position": "Yes"
          },
          "republican": {
            "yes": "49",
            "no": "0",
            "present": "0",
            "not_voting": "5",
            "majority_position": "Yes"
          },
          "independent": {
            "yes": "1",
            "no": "0",
            "present": "0",
            "not_voting": "1"
          },
          "total": {
            "yes": "93",
            "no": "0",
            "present": "0",
            "not_voting": "7",
            "margin": "93"
          }
        },
        ...
        {
          "congress": "114",
          "session": "1",
          "roll_call": "54",
          "question": "On the Nomination",
          "description": "Michael P. Botticelli, of the District of Columbia, to be Director of National Drug Control Policy",
          "vote_type": "1/2",
          "date": "2015-02-09",
          "time": "17:32:00",
          "result": "Nomination Confirmed",
          "tie_breaker": "",
          "tie_breaker_vote": "",
          "nominee_uri": "https://api.propublica.org/congress/v1/114/nominees/PN60.json",
          "democratic": {
            "yes": "44",
            "no": "0",
            "present": "0",
            "not_voting": "0",
            "majority_position": "Yes"
          },
          "republican": {
            "yes": "46",
            "no": "0",
            "present": "0",
            "not_voting": "8",
            "majority_position": "Yes"
          },
          "independent": {
            "yes": "2",
            "no": "0",
            "present": "0",
            "not_voting": "0"
          },
          "total": {
            "yes": "92",
            "no": "0",
            "present": "0",
            "not_voting": "8",
            "margin": "92"
          }
        }
      ]
    }
  ]
}

To get Senate votes on presidential nominations, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/nominations.json

URL Parameters

Parameter Description
congress 101-115

Bills

Get Recent Bills

curl "https://api.propublica.org/congress/v1/115/house/bills/introduced.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "congress": "114",
      "chamber": "House",
      "num_results": "20",
      "offset": "0",
      "bills": [
        {
          "number": "H.R.4881",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4881.json",
          "title": "Healthy Food Choices Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/R000582.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Agriculture Committee",
          "latest_major_action_date": "March 31, 2016",
          "latest_major_action": "Referred to the Subcommittee on Nutrition."
        },
        {
          "number": "H.R.4882",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4882.json",
          "title": "Cesar Chavez National Historical Park Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/R000599.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "1",
          "committees": "House Natural Resources Committee",
          "latest_major_action_date": "March 29, 2016",
          "latest_major_action": "Referred to the Subcommittee on Federal Lands."
        },
        {
          "number": "H.R.4885",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4885.json",
          "title": "IRS Oversight While Eliminating Spending (OWES) Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/S001195.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "6",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "number": "H.R.4889",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4889.json",
          "title": "Kelsey Smith Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/Y000063.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "3",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Energy and Commerce."
        },
        {
          "number": "H.R.4846",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4846.json",
          "title": "To amend the Internal Revenue Code of 1986 to increase the child tax credit.",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/C001105.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "5",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "number": "H.R.4884",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4884.json",
          "title": "CURB Lifeline Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/S001189.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Energy and Commerce."
        },
        {
          "number": "H.R.4861",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4861.json",
          "title": "Access to Substance Abuse Treatment Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/D000216.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Energy and Commerce."
        },
        {
          "number": "H.R.4868",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4868.json",
          "title": "Rural Main Street Investment Credit Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/K000188.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "number": "H.R.4862",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4862.json",
          "title": "Sustainable Water Supplies Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/D000623.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "1",
          "committees": "House Natural Resources Committee",
          "latest_major_action_date": "March 28, 2016",
          "latest_major_action": "Referred to the Subcommittee on Water, Power and Oceans."
        },
        {
          "number": "H.R.4886",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4886.json",
          "title": "Closing the Pre-Paid Mobile Device Security Gap Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/S001175.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Judiciary Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to House Judiciary"
        },
        {
          "number": "H.R.4852",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4852.json",
          "title": "Private Placement Improvement Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/G000548.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Financial Services Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Financial Services."
        },
        {
          "number": "H.R.4883",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4883.json",
          "title": "To prohibit the Department of State from obligating or expending any funds to hire a contractor to deliver interactive, professional training seminars for senior-level officials on effective congressional testimony and briefing skills, and for other purposes.",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/S000018.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Appropriations Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to House Appropriations"
        },
        {
          "number": "H.R.4854",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4854.json",
          "title": "Supporting America's Innovators Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001156.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Financial Services Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Financial Services."
        },
        {
          "number": "H.R.4874",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4874.json",
          "title": "Prevent ABUSE Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001181.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "6",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Energy and Commerce."
        },
        {
          "number": "H.R.4875",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4875.json",
          "title": "United States Semiquincentennial Commission Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001181.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "1",
          "committees": "House Oversight and Government Reform Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Oversight and Government Reform."
        },
        {
          "number": "H.R.4872",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4872.json",
          "title": "Save for Success Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/L000570.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Education and the Workforce Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to House Education and the Workforce"
        },
        {
          "number": "H.R.4887",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4887.json",
          "title": "To designate the facility of the United States Postal Service located at 23323 Shelby Road in Shelby, Indiana, as the 'Richard Allen Cable Post Office'.",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/V000108.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Oversight and Government Reform Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Oversight and Government Reform."
        },
        {
          "number": "H.R.4855",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4855.json",
          "title": "Fix Crowdfunding Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/M001156.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "0",
          "committees": "House Financial Services Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Financial Services."
        },
        {
          "number": "H.R.4867",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4867.json",
          "title": "Working Families Relief Act",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/K000376.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "1",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "number": "H.R.4851",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4851.json",
          "title": "Electronic Warfare Capabilities Enhancement Act of 2016",
          "sponsor_uri": "https://api.propublica.org/congress/v1/members/W000813.json",
          "introduced_date": "March 23, 2016",
          "cosponsors": "1",
          "committees": "House Armed Services Committee",
          "latest_major_action_date": "March 23, 2016",
          "latest_major_action": "Referred to the House Committee on Armed Services."
        }
      ]
    }
  ]
}

Use this request type to get 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.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/bills/{type}.json

URL Parameters

Parameter Description
congress 105-115
chamber house or senate
type introduced, updated, passed or major

Get Recent Bills by a Specific Member

curl "https://api.propublica.org/congress/v1/members/L000287/bills/introduced.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "id": "L000287",
      "member_uri": "https://api.propublica.org/congress/v1/members/L000287.json",
      "name": "John  Lewis",
      "num_results": "20",
      "offset": "0",
      "bills": [
        {
          "congress": "114",
          "number": "H.R.4645",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4645.json",
          "title": "Environmental Justice Act of 2016",
          "sponsor_id": "L000287",
          "introduced_date": "2016-02-26",
          "cosponsors": "0",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2016-02-26",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.4627",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4627.json",
          "title": "Medicaid Expansion Parity Act of 2016",
          "sponsor_id": "L000287",
          "introduced_date": "2016-02-25",
          "cosponsors": "0",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2016-02-25",
          "latest_major_action": "Referred to the House Committee on Energy and Commerce."
        },
        {
          "congress": "114",
          "number": "H.R.3550",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3550.json",
          "title": "Civil Justice Tax Fairness Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-09-17",
          "cosponsors": "1",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-09-17",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.3367",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3367.json",
          "title": "Stephanie Tubbs Jones Assets for Independence Reauthorization Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-07-29",
          "cosponsors": "0",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-07-29",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.3368",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr3368.json",
          "title": "Back to Basics Job Creation Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-07-29",
          "cosponsors": "0",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-07-29",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.RES.368",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hres368.json",
          "title": "Expressing the sense of the House of Representatives on Nelson Mandela International Day.",
          "sponsor_id": "L000287",
          "introduced_date": "2015-07-16",
          "cosponsors": "25",
          "committees": "House Foreign Affairs Committee",
          "latest_major_action_date": "2015-07-16",
          "latest_major_action": "Referred to the House Committee on Foreign Affairs."
        },
        {
          "congress": "114",
          "number": "H.R.2880",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2880.json",
          "title": "Martin Luther King, Jr. National Historical Park Act of 2016",
          "sponsor_id": "L000287",
          "introduced_date": "2015-06-24",
          "cosponsors": "77",
          "committees": "House Energy and Natural Resources Committee",
          "latest_major_action_date": "2016-03-17",
          "latest_major_action": "Committee on Energy and Natural Resources Subcommittee on National Parks. Hearings held."
        },
        {
          "congress": "114",
          "number": "H.RES.285",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hres285.json",
          "title": "Expressing the sense of the House of Representatives that the United States should become an international human rights leader by ratifying and implementing certain core international conventions.",
          "sponsor_id": "L000287",
          "introduced_date": "2015-05-21",
          "cosponsors": "0",
          "committees": "House Foreign Affairs Committee",
          "latest_major_action_date": "2015-08-20",
          "latest_major_action": "Referred to the Subcommittee on Africa, Global Health, Global Human Rights and International Organizations."
        },
        {
          "congress": "114",
          "number": "H.R.2449",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2449.json",
          "title": "Every Child Deserves a Family Act",
          "sponsor_id": "L000287",
          "introduced_date": "2015-05-19",
          "cosponsors": "104",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-05-19",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.2377",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2377.json",
          "title": "Religious Freedom Peace Tax Fund Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-05-15",
          "cosponsors": "0",
          "committees": "House Ways and Means Committee",
          "latest_major_action_date": "2015-05-15",
          "latest_major_action": "Referred to the House Committee on Ways and Means."
        },
        {
          "congress": "114",
          "number": "H.R.2376",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2376.json",
          "title": "Cost of War Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-05-15",
          "cosponsors": "4",
          "committees": "House Armed Services Committee",
          "latest_major_action_date": "2015-05-15",
          "latest_major_action": "Referred to the House Committee on Armed Services."
        },
        {
          "congress": "114",
          "number": "H.R.12",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr12.json",
          "title": "Voter Empowerment Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-03-19",
          "cosponsors": "179",
          "committees": "House Education and the Workforce Committee",
          "latest_major_action_date": "2015-04-29",
          "latest_major_action": "Referred to the Subcommittee on Higher Education and Workforce Training."
        },
        {
          "congress": "114",
          "number": "H.R.1502",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr1502.json",
          "title": "Medicaid Parity Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-03-19",
          "cosponsors": "11",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-03-20",
          "latest_major_action": "Referred to the Subcommittee on Health."
        },
        {
          "congress": "114",
          "number": "H.RES.114",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hres114.json",
          "title": "Expressing support for designation of the month of February 2015 as 'National Teen Dating Violence Awareness and Prevention Month'.",
          "sponsor_id": "L000287",
          "introduced_date": "2015-02-13",
          "cosponsors": "5",
          "committees": "House Judiciary Committee",
          "latest_major_action_date": "2015-03-17",
          "latest_major_action": "Referred to the Subcommittee on Crime, Terrorism, Homeland Security, and Investigations."
        },
        {
          "congress": "114",
          "number": "H.R.943",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr943.json",
          "title": "Medicare Employer Relief Act of 2015",
          "sponsor_id": "L000287",
          "introduced_date": "2015-02-12",
          "cosponsors": "1",
          "committees": "House Energy and Commerce Committee",
          "latest_major_action_date": "2015-02-12",
          "latest_major_action": "Referred to House Energy and Commerce"
        },
        {
          "congress": "114",
          "number": "H.RES.4",
          "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hres4.json",
          "title": "Authorizing the Clerk to inform the President of the election of the Speaker and the Clerk.",
          "sponsor_id": "L000287",
          "introduced_date": "2015-01-06",
          "cosponsors": "0",
          "committees": "",
          "latest_major_action_date": "2015-01-06",
          "latest_major_action": "Motion to reconsider laid on the table Agreed to without objection."
        },
        {
          "congress": "113",
          "number": "H.R.5623",
          "bill_uri": "https://api.propublica.org/congress/v1/113/bills/hr5623.json",
          "title": "National Parents Corps Act of 2014",
          "sponsor_id": "L000287",
          "introduced_date": "2014-09-18",
          "cosponsors": "2",
          "committees": "House Education and the Workforce",
          "latest_major_action_date": "2014-11-17",
          "latest_major_action": "Referred to House subcommittee. Status: Referred to the Subcommittee on Early Childhood, Elementary, and Secondary Education."
        },
        {
          "congress": "113",
          "number": "H.R.5517",
          "bill_uri": "https://api.propublica.org/congress/v1/113/bills/hr5517.json",
          "title": "Martin Luther King, Jr. National Historical Park Act of 2014",
          "sponsor_id": "L000287",
          "introduced_date": "2014-09-17",
          "cosponsors": "19",
          "committees": "House Natural Resources",
          "latest_major_action_date": "2014-09-24",
          "latest_major_action": "Referred to House subcommittee. Status: Referred to the Subcommittee on Public Lands and Environmental Regulation."
        },
        {
          "congress": "113",
          "number": "H.R.5353",
          "bill_uri": "https://api.propublica.org/congress/v1/113/bills/hr5353.json",
          "title": "Medicaid Parity Act of 2014",
          "sponsor_id": "L000287",
          "introduced_date": "2014-07-31",
          "cosponsors": "6",
          "committees": "House Energy and Commerce",
          "latest_major_action_date": "2014-08-01",
          "latest_major_action": "Referred to House subcommittee. Status: Referred to the Subcommittee on Health."
        },
        {
          "congress": "113",
          "number": "H.RES.672",
          "bill_uri": "https://api.propublica.org/congress/v1/113/bills/hres672.json",
          "title": "Providing for the consideration of the bill (H.R. 12) to modernize voter registration, promote access to voting for individuals with disabilities, protect the ability of individuals to exercise the right to vote in elections for Federal office, and for other purposes.",
          "sponsor_id": "L000287",
          "introduced_date": "2014-07-16",
          "cosponsors": "0",
          "committees": "House Rules",
          "latest_major_action_date": "2014-07-16",
          "latest_major_action": "Referred to House committee. Status: Referred to the House Committee on Rules."
        }
      ]
    }
  ]
}

Use this request type to get the 20 bills most recently introduced or updated by a particular member. Results can include more than one Congress.

HTTP Request

GET https://api.propublica.org/congress/v1/members/{member-id}/bills/{type}.json

URL Parameters

Parameter Description
member-id The ID of the member to retrieve; it is assigned by the Biographical Directory of the United States Congress or can be retrieved from a member list request.
type introduced or updated

Get a Specific Bill

curl "https://api.propublica.org/congress/v1/115/bills/hr21.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":"Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "bill_id": "hr21-115",
         "congress": "115",
         "bill": "H.R.21",
         "bill_type": "hr",
         "number": "H.R.21",
         "bill_uri": "https://api.propublica.org/congress/v1/115/bills/hr21.json",
         "title": "Midnight Rules Relief Act of 2017",
         "sponsor": "Darrell Issa",
         "sponsor_id": "I000056",
         "sponsor_uri": "https://api.propublica.org/congress/v1/members/I000056.json",
         "sponsor_party": "R",
         "sponsor_state": "CA",
         "gpo_pdf_uri": "",
         "congressdotgov_url": "https://www.congress.gov/bill/115th-congress/house-bill/21",
         "govtrack_url": "https://www.govtrack.us/congress/bills/115/hr21",
         "introduced_date": "2017-01-03",
         "active": "true",
         "house_passage": "2017-01-04",
         "senate_passage": "",
         "enacted": "",
         "vetoed": "",
         "cosponsors": "14",
         "withdrawn_cosponsors": "0",
         "primary_subject": "Government Operations and Politics",
         "committees": "Senate Homeland Security and Governmental Affairs Committee",
         "latest_major_action_date": "2017-01-05",
         "latest_major_action": "Received in the Senate and Read twice and referred to the Committee on Homeland Security and Governmental Affairs.",
         "last_vote_date": "2017-01-04",
         "house_passage_vote": "2017-01-04",
         "senate_passage_vote": null,
         "summary": "<p>(This measure has not been amended since it was introduced. The summary has been expanded because action occurred on the measure.)</p> <p><b>Midnight Rules Relief Act of 2017</b></p> <p>(Sec. 2) This bill amends the Congressional Review Act to allow Congress to consider a joint resolution to disapprove multiple regulations that federal agencies have submitted for congressional review within the last 60 legislative days of a session of Congress during the final year of a President's term. Congress may disapprove a group of such regulations together (i.e., \"en bloc\") instead of the current procedure of considering only one regulation at a time.</p>",
         "summary_short": "(This measure has not been amended since it was introduced. The summary has been expanded because action occurred on the measure.) Midnight Rules Relief Act of 2017 (Sec. 2) This bill amends the Congressional Review Act to allow Congress to consider a joint resolution to disapprove multiple regulations that federal agencies have submitted for congressional review within the last 60 legislative days of a session of Congress during the final year of a President&#39;s term. Congress may disapprove a...",
         "versions":[
],
         "actions":[
         {
           "datetime": "2017-01-05 00:00:00 UTC",
           "description": "Received in the Senate and Read twice and referred to the Committee on Homeland Security and Governmental Affairs."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Motion to reconsider laid on the table Agreed to without objection."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "On passage Passed by recorded vote: 238 - 184 (Roll no. 8)."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "On motion to recommit with instructions Failed by the Yeas and Nays: 183 - 236 (Roll no. 7)."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Considered as unfinished business."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "POSTPONED PROCEEDINGS - At the conclusion of debate on the Castor (FL) motion to recommit, the Chair put the question on adoption of the motion to recommit and by voice vote, announced that the noes had prevailed. Ms. Castor (FL) demanded the yeas and nays and the Chair postponed further proceedings on adoption of the motion to recommit until a time to be announced."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "The previous question on the motion to recommit with instructions was ordered without objection."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "DEBATE - The House proceeded with 10 minutes of debate on the Castor (FL) motion to recommit with instructions. The instructions contained in the motion seek to require the bill to be reported back to the House with an amendment to add at the end of the bill a section 3 pertaining to exception for certain rules that prohibit discrimination by insurance issuers on the basis of gender or preexisting condition or that make healthcare more affordable for working Americans."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Ms. Castor (FL) moved to recommit with instructions to the Committee on the Judiciary."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "The previous question was ordered pursuant to the rule."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "DEBATE - The House proceeded with one hour of debate on H.R. 21."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "The rule provides for one hour of debate and one motion to recommit."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Considered under the provisions of rule H. Res. 5."
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "On passage Passed by recorded vote: 238 - 184 (Roll no. 8). (text: CR H74)"
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Considered as unfinished business. (consideration: CR H86-87)"
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Ms. Castor (FL) moved to recommit with instructions to the Committee on the Judiciary. (text: CR H84)"
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Considered under the provisions of rule H. Res. 5. (consideration: CR H74-78)"
         },
                  {
           "datetime": "2017-01-04 00:00:00 UTC",
           "description": "Considered under the provisions of rule H. Res. 5. (consideration: CR H74-86)"
         },
                  {
           "datetime": "2017-01-03 00:00:00 UTC",
           "description": "Referred to House Rules"
         },
                  {
           "datetime": "2017-01-03 00:00:00 UTC",
           "description": "Referred to House Judiciary"
         },
                  {
           "datetime": "2017-01-03 00:00:00 UTC",
           "description": "Referred to the Subcommittee on Regulatory Reform, Commercial And Antitrust Law."
         }
         ],
         "votes": [
           {
             "chamber": "House",
             "date": "2017-01-04",
             "time": "16:48",
             "roll_call": "8",
             "question": "On Passage",
             "result": "Passed",
             "total_yes": "238",
             "total_no": "184",
             "total_not_voting": "11",
             "api_url": "https://api.propublica.org/congress/v1/115/house/sessions/1/votes/8.json"
           },
           {
             "chamber": "House",
             "date": "2017-01-04",
             "time": "16:38",
             "roll_call": "7",
             "question": "On Motion to Recommit with Instructions",
             "result": "Failed",
             "total_yes": "183",
             "total_no": "236",
             "total_not_voting": "14",
             "api_url": "https://api.propublica.org/congress/v1/115/house/sessions/1/votes/7.json"
           }
         ]

      }
   ]
}

Use this request type to get details about a particular bill, including actions taken and votes.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/bills/{bill-id}.json

URL Parameters

Parameter Description
congress 105-115
bill-id a bill slug, for example hr4881 - these can be found in the recent bill response.
curl "https://api.propublica.org/congress/v1/114/bills/hr2393/subjects.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "congress": "114",
      "bill": "H.R.2393",
      "url_number": "hr2393",
      "title": "Country of Origin Labeling Amendments Act of 2015",
      "sponsor": "K. Michael Conaway",
      "sponsor_id": "C001062",
      "introduced_date": "2015-05-18",
      "cosponsors": "82",
      "committees": "House Agriculture Committee",
      "latest_major_action_date": "2015-06-11",
      "latest_major_action": "Received in the Senate.",
      "house_passage_vote": "",
      "senate_passage_vote": "",
      "subjects": [
        {
          "name": "Meat",
          "url_name": "meat"
        },
        {
          "name": "Agricultural trade",
          "url_name": "agricultural-trade"
        },
        {
          "name": "Agricultural marketing and promotion",
          "url_name": "agricultural-marketing-and-promotion"
        },
        {
          "name": "Agriculture and Food",
          "url_name": "agriculture-and-food"
        }
      ]
    }
  ]
}

Use this request type to get additional details about a particular bill, including its subjects, amendments and related bills.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/bills/{bill-id}/{type}.json

URL Parameters

Parameter Description
congress 105-115
bill-id bill slug, for example hr4881 - these can be found in Recent bill response.
type subjects, amendments or related

Get Cosponsors for a Specific Bill

curl "https://api.propublica.org/congress/v1/114/bills/hr4249/cosponsors.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
   "status":"OK",
   "copyright":"Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
   "results":[
      {
         "congress": "114",
         "bill": "H.R.4249",
         "url_number": "hr4249",
         "title": "Police Agency Investigation Improvement Act of 2015",
         "sponsor": "Hank Johnson",
         "sponsor_id": "J000288",
         "introduced_date": "2015-12-15",
         "number_of_cosponsors": "18",
         "committees": "House Judiciary Committee",
         "latest_major_action_date": "2016-01-15",
         "latest_major_action": "Referred to the Subcommittee on Crime, Terrorism, Homeland Security, and Investigations.",
         "house_passage_vote": "",
         "senate_passage_vote": "",
             "cosponsors_by_party":[
    {
      "party": {
        "id": "D",
        "sponsors": "18"
      }
    }
    ],
         "cosponsors":[
         {
           "cosponsor_id": "W000187",
           "name": "Maxine Waters",
           "date": "2016-03-15"
         },
                  {
           "cosponsor_id": "F000455",
           "name": "Marcia L. Fudge",
           "date": "2016-02-26"
         },
                  {
           "cosponsor_id": "R000053",
           "name": "Charles B. Rangel",
           "date": "2016-02-23"
         },
                  {
           "cosponsor_id": "M001166",
           "name": "Jerry McNerney",
           "date": "2016-02-12"
         },
                  {
           "cosponsor_id": "N000147",
           "name": "Eleanor Holmes Norton",
           "date": "2016-02-09"
         },
                  {
           "cosponsor_id": "S001157",
           "name": "David Scott",
           "date": "2016-02-03"
         },
                  {
           "cosponsor_id": "T000472",
           "name": "Mark Takano",
           "date": "2016-02-02"
         },
                  {
           "cosponsor_id": "C000984",
           "name": "Elijah E. Cummings",
           "date": "2016-02-02"
         },
                  {
           "cosponsor_id": "C001072",
           "name": "André  Carson",
           "date": "2016-02-01"
         },
                  {
           "cosponsor_id": "B001270",
           "name": "Karen Bass",
           "date": "2016-02-01"
         },
                  {
           "cosponsor_id": "H000324",
           "name": "Alcee L. Hastings",
           "date": "2016-02-01"
         },
                  {
           "cosponsor_id": "G000556",
           "name": "Alan Grayson",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "E000179",
           "name": "Eliot L. Engel",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "R000588",
           "name": "Cedric Richmond",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "R000515",
           "name": "Bobby L. Rush",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "C001068",
           "name": "Steve Cohen",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "M001137",
           "name": "Gregory W. Meeks",
           "date": "2016-01-25"
         },
                  {
           "cosponsor_id": "J000032",
           "name": "Sheila Jackson-Lee",
           "date": "2016-01-25"
         }
         ]
      }
   ]
}

To get information about the cosponsors of a particular bill, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/bills/{bill-id}/cosponsors.json

URL Parameters

Parameter Description
congress 105-115
bill-id bill slug, for example hr4881 - these can be found in Recent bill response.

Nominations

Get Recent Nominations by Category

curl "https://api.propublica.org/congress/v1/115/nominees/confirmed.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "congress": 115,
    "results": [{
        "id": "PN33",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN33.json",
        "date_received": "2017-01-20",
        "name": "Thomas Price",
        "description": "Thomas Price, of Georgia, to be Secretary of Health and Human Services.",
        "nominee_state": "GA",
        "committee_id": "SSFI",
        "committee_uri": "https://api.propublica.org/represent/v1/115/senate/committees/SSFI.json",
        "latest_action_date": "2017-02-10",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 52 - 47.",
        "organization": "Department of Health and Human Services",
        "status": "Confirmed"
    }, {
        "id": "PN30",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN30.json",
        "date_received": "2017-01-20",
        "name": "Jeff Sessions",
        "description": "Jeff Sessions, of Alabama, to be Attorney General.",
        "nominee_state": "AL",
        "committee_id": "SSJU",
        "committee_uri": "https://api.propublica.org/represent/v1/115/senate/committees/SSJU.json",
        "latest_action_date": "2017-02-08",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 52 - 47.",
        "organization": "Department of Justice",
        "status": "Confirmed"
    }, {
        "id": "PN35",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN35.json",
        "date_received": "2017-01-20",
        "name": "Elaine L. Chao",
        "description": "Elaine L. Chao, of Kentucky, to be Secretary of Transportation.",
        "nominee_state": "KY",
        "committee_id": "SSCM",
        "committee_uri": "https://api.propublica.org/represent/v1/115/senate/committees/SSCM.json",
        "latest_action_date": "2017-01-31",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 93 - 6.",
        "organization": "Department of Transportation",
        "status": "Confirmed"
    }, {
        "id": "PN51",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN51.json",
        "date_received": "2017-01-20",
        "name": "Nikki R. Haley",
        "description": "Nikki R. Haley, of South Carolina, to be Representative of the United States of America to the Sessions of the General Assembly of the United Nations during her tenure of service as Representative of the United States of America to the United Nations.",
        "nominee_state": "SC",
        "committee_id": "SSFR",
        "committee_uri": "https://api.propublica.org/represent/v1/115/senate/committees/SSFR.json",
        "latest_action_date": "2017-01-24",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 96 - 4.",
        "organization": "United Nations",
        "status": "Confirmed"
    }, {
        "id": "PN50",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN50.json",
        "date_received": "2017-01-20",
        "name": "Nikki R. Haley",
        "description": "Nikki R. Haley, of South Carolina, to be the Representative of the United States of America to the United Nations, with the rank and status of Ambassador Extraordinary and Plenipotentiary, and the Representative of the United States of America in the Security Council of the United Nations.",
        "nominee_state": "SC",
        "committee_id": "SSFR",
        "committee_uri": "https://api.propublica.org/represent/v1/115/senate/committees/SSFR.json",
        "latest_action_date": "2017-01-24",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 96 - 4.",
        "organization": "Department of State",
        "status": "Confirmed"
    }, {
        "id": "PN43",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN43.json",
        "date_received": "2017-01-20",
        "name": "Mike Pompeo",
        "description": "Mike Pompeo, of Kansas, to be Director of the Central Intelligence Agency, vice John Owen Brennan.",
        "nominee_state": "KS",
        "committee_id": null,
        "committee_uri": null,
        "latest_action_date": "2017-01-23",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 66 - 32.",
        "organization": "Central Intelligence Agency",
        "status": "Confirmed"
    }, {
        "id": "PN40",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN40.json",
        "date_received": "2017-01-20",
        "name": "John F. Kelly",
        "description": "John F. Kelly, of Virginia, to be Secretary of Homeland Security.",
        "nominee_state": "VA",
        "committee_id": null,
        "committee_uri": null,
        "latest_action_date": "2017-01-20",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 88 - 11.",
        "organization": "Department of Homeland Security",
        "status": "Confirmed"
    }, {
        "id": "PN29",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN29.json",
        "date_received": "2017-01-20",
        "name": "James Mattis",
        "description": "James Mattis, of Washington, to be Secretary of Defense.",
        "nominee_state": "WA",
        "committee_id": null,
        "committee_uri": null,
        "latest_action_date": "2017-01-20",
        "latest_action_text": "Confirmed by the Senate by Yea-Nay Vote. 98 - 1.",
        "organization": "Department of Defense",
        "status": "Confirmed"
    }]
}

To get lists of presidential nominations for civilian positions, use the following URI structure. This request returns the 20 most recent results for the specified type: received, updated, confirmed or withdrawn.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/nominees/{type}.json

URL Parameters

Parameter Description
congress 107-115
type received, updated, confirmed, withdrawn

Get a Specific Nomination

curl "https://api.propublica.org/congress/v1/115/nominees/PN40.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "results": [{
        "congress": 115,
        "id": "PN40",
        "date_received": "2017-01-20",
        "description": "John F. Kelly, of Virginia, to be Secretary of Homeland Security.",
        "nominee_state": "VA",
        "committee_uri": null,
        "latest_action_date": "2017-01-20",
        "status": "Confirmed",
        "actions": [{
            "date": "2017-01-20",
            "description": "Confirmed by the Senate by Yea-Nay Vote. 88 - 11."
        }, {
            "date": "2017-01-20",
            "description": "Considered by Senate."
        }, {
            "date": "2017-01-20",
            "description": "Received in the Senate."
        }, {
            "date": "2017-01-10",
            "description": "Senate Committee on Homeland Security and Governmental Affairs. Hearings held prior to introduction and/or referral."
        }],
        "votes": [{
            "uri": "https://api.propublica.org/congress/v1/115/senate/sessions/1/votes/30.json",
            "date": "2017-01-20",
            "roll_call": 30,
            "question": "On the Nomination",
            "result": "Nomination Confirmed",
            "total_yes": 88,
            "total_no": 11,
            "total_not_voting": 1
        }]
    }]
}

To get details about a particular presidential civilian nomination, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/nominees/{nominee-id}.json

URL Parameters

Parameter Description
congress 107-115
nominee-id alphanumeric ID beginning with PN - for example, PN675

Get Nominees by State

curl "https://api.propublica.org/congress/v1/115/nominees/state/VA.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "congress": 115,
    "num_results": 4,
    "state": "VA",
    "results": [{
        "id": "PN59",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN59.json",
        "date_received": "2017-02-08",
        "description": "Elaine C. Duke, of Virginia, to be Deputy Secretary of Homeland Security, vice Alejandro Nicholas Mayorkas.",
        "nominee_state": "VA",
        "committee": "Committee on Homeland Security and Governmental Affairs",
        "latest_action_date": "2017-02-08",
        "status": "Pending"
    }, {
        "id": "PN58",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN58.json",
        "date_received": "2017-02-01",
        "description": "Steven Andrew Engel, of the District of Columbia, to be an Assistant Attorney General, vice Virginia A. Seitz, resigned.",
        "nominee_state": "VA",
        "committee": "Committee on the Judiciary",
        "latest_action_date": "2017-02-01",
        "status": "Pending"
    }, {
        "id": "PN40",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN40.json",
        "date_received": "2017-01-20",
        "description": "John F. Kelly, of Virginia, to be Secretary of Homeland Security.",
        "nominee_state": "VA",
        "committee": null,
        "latest_action_date": "2017-01-20",
        "status": "Confirmed"
    }, {
        "id": "PN7",
        "uri": "https://api.propublica.org/congress/v1/115/nominees/PN7.json",
        "date_received": "2017-01-04",
        "description": "Tulinabo Salama Mushingi, of Virginia, a Career Member of the Senior Foreign Service, Class of Counselor, to be Ambassador Extraordinary and Plenipotentiary of the United States of America to the Republic of Senegal, and to serve concurrently and without additional compensation as Ambassador Extraordinary and Plenipotentiary of the United States of America to the Republic of Guinea-Bissau.",
        "nominee_state": "VA",
        "committee": "Committee on Foreign Relations",
        "latest_action_date": "2017-01-04",
        "status": "Pending"
    }]
}

To get a list of presidential civilian nominations of individuals from a specific state, use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/nominees/state/{state}.json

URL Parameters

Parameter Description
congress 107-115
state Two-letter state abbreviation

Other Responses

Get State Party Counts

curl "https://api.propublica.org/congress/v1/states/members/party.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": " Copyright (c) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": {
    "senate": [
      {
        "AK": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "AL": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "AR": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "AZ": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "CA": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "CO": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "CT": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "DE": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "FL": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "GA": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "HI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "IA": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "ID": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "IL": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "IN": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "KS": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "KY": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "LA": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "MA": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "MD": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "ME": [
          {
            "I": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "MI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "MN": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "MO": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "MS": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "MT": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NC": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "ND": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NE": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "NH": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NJ": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "NM": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "NV": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NY": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "OH": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "OK": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "OR": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "PA": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "RI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "SC": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "SD": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "TN": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "TX": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "UT": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "VA": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "VT": [
          {
            "DEM": "1"
          },
          {
            "I": "1"
          }
        ]
      },
      {
        "WA": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "WI": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "WV": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "WY": [
          {
            "REP": "2"
          }
        ]
      }
    ],
    "house": [
      {
        "AK": [
          {
            "REP": "1"
          }
        ]
      },
      {
        "AL": [
          {
            "DEM": "1"
          },
          {
            "REP": "6"
          }
        ]
      },
      {
        "AR": [
          {
            "REP": "4"
          }
        ]
      },
      {
        "AS": [
          {
            "REP": "1"
          }
        ]
      },
      {
        "AZ": [
          {
            "DEM": "4"
          },
          {
            "REP": "5"
          }
        ]
      },
      {
        "CA": [
          {
            "DEM": "39"
          },
          {
            "REP": "14"
          }
        ]
      },
      {
        "CO": [
          {
            "DEM": "3"
          },
          {
            "REP": "4"
          }
        ]
      },
      {
        "CT": [
          {
            "DEM": "5"
          }
        ]
      },
      {
        "DC": [
          {
            "DEM": "1"
          }
        ]
      },
      {
        "DE": [
          {
            "DEM": "1"
          }
        ]
      },
      {
        "FL": [
          {
            "DEM": "10"
          },
          {
            "REP": "17"
          }
        ]
      },
      {
        "GA": [
          {
            "DEM": "4"
          },
          {
            "REP": "10"
          }
        ]
      },
      {
        "GU": [
          {
            "DEM": "1"
          }
        ]
      },
      {
        "HI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "IA": [
          {
            "DEM": "1"
          },
          {
            "REP": "3"
          }
        ]
      },
      {
        "ID": [
          {
            "REP": "2"
          }
        ]
      },
      {
        "IL": [
          {
            "DEM": "10"
          },
          {
            "REP": "8"
          }
        ]
      },
      {
        "IN": [
          {
            "DEM": "2"
          },
          {
            "REP": "7"
          }
        ]
      },
      {
        "KS": [
          {
            "REP": "4"
          }
        ]
      },
      {
        "KY": [
          {
            "DEM": "1"
          },
          {
            "REP": "5"
          }
        ]
      },
      {
        "LA": [
          {
            "DEM": "1"
          },
          {
            "REP": "5"
          }
        ]
      },
      {
        "MA": [
          {
            "DEM": "9"
          }
        ]
      },
      {
        "MD": [
          {
            "DEM": "7"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "ME": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "MI": [
          {
            "DEM": "5"
          },
          {
            "REP": "9"
          }
        ]
      },
      {
        "MN": [
          {
            "DEM": "5"
          },
          {
            "REP": "3"
          }
        ]
      },
      {
        "MO": [
          {
            "DEM": "2"
          },
          {
            "REP": "6"
          }
        ]
      },
      {
        "MP": [
          {
            "I": "1"
          }
        ]
      },
      {
        "MS": [
          {
            "DEM": "1"
          },
          {
            "REP": "3"
          }
        ]
      },
      {
        "MT": [
          {
            "REP": "1"
          }
        ]
      },
      {
        "NC": [
          {
            "DEM": "3"
          },
          {
            "REP": "10"
          }
        ]
      },
      {
        "ND": [
          {
            "REP": "1"
          }
        ]
      },
      {
        "NE": [
          {
            "DEM": "1"
          },
          {
            "REP": "2"
          }
        ]
      },
      {
        "NH": [
          {
            "DEM": "1"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NJ": [
          {
            "DEM": "6"
          },
          {
            "REP": "6"
          }
        ]
      },
      {
        "NM": [
          {
            "DEM": "2"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "NV": [
          {
            "DEM": "1"
          },
          {
            "REP": "3"
          }
        ]
      },
      {
        "NY": [
          {
            "DEM": "18"
          },
          {
            "REP": "9"
          }
        ]
      },
      {
        "OH": [
          {
            "DEM": "4"
          },
          {
            "REP": "11"
          }
        ]
      },
      {
        "OK": [
          {
            "REP": "5"
          }
        ]
      },
      {
        "OR": [
          {
            "DEM": "4"
          },
          {
            "REP": "1"
          }
        ]
      },
      {
        "PA": [
          {
            "DEM": "5"
          },
          {
            "REP": "13"
          }
        ]
      },
      {
        "PR": [
          {
            "DEM": "1"
          }
        ]
      },
      {
        "RI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "SC": [
          {
            "DEM": "1"
          },
          {
            "REP": "6"
          }
        ]
      },
      {
        "SD": [
          {
            "REP": "1"
          }
        ]
      },
      {
        "TN": [
          {
            "DEM": "2"
          },
          {
            "REP": "7"
          }
        ]
      },
      {
        "TX": [
          {
            "DEM": "11"
          },
          {
            "REP": "25"
          }
        ]
      },
      {
        "UT": [
          {
            "REP": "4"
          }
        ]
      },
      {
        "VA": [
          {
            "DEM": "3"
          },
          {
            "REP": "8"
          }
        ]
      },
      {
        "VI": [
          {
            "DEM": "2"
          }
        ]
      },
      {
        "VT": [
          {
            "DEM": "1"
          }
        ]
      },
      {
        "WA": [
          {
            "DEM": "6"
          },
          {
            "REP": "4"
          }
        ]
      },
      {
        "WI": [
          {
            "DEM": "3"
          },
          {
            "REP": "5"
          }
        ]
      },
      {
        "WV": [
          {
            "REP": "3"
          }
        ]
      },
      {
        "WY": [
          {
            "REP": "1"
          }
        ]
      }
    ]
  }
}

To get party membership counts for all states (current Congress only), use the following URI structure:

HTTP Request

GET https://api.propublica.org/congress/v1/states/members/party.json

Get Committees and Committee Memberships

curl "https://api.propublica.org/congress/v1/115/house/committees.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
    "status": "OK",
    "copyright": "Copyright (c) 2017 Pro Publica Inc. All Rights Reserved.",
    "results": [{
        "congress": "115",
        "chamber": "House",
        "num_results": "22",
        "committees": [{
            "id": "HSHA",
            "name": "Committee on Administration",
            "url": "http://cha.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSHA.json",
            "chair": "Gregg Harper",
            "chair_id": "H001045",
            "chair_party": "R",
            "chair_state": "MS",
            "chair_uri": "https://api.propublica.org/congress/v1/members/H001045.json",
            "ranking_member_id": "B001227",
            "subcommittees": []
        }, {
            "id": "HSAG",
            "name": "Committee on Agriculture",
            "url": "http://agriculture.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSAG.json",
            "chair": "K. Michael Conaway",
            "chair_id": "C001062",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/C001062.json",
            "ranking_member_id": "P000258",
            "subcommittees": [{
                "id": "HSAG15",
                "name": "Conservation and Forestry"
            }, {
                "id": "HSAG22",
                "name": "Commodity Exchanges, Energy, and Credit"
            }, {
                "id": "HSAG16",
                "name": "General Farm Commodities and Risk Management"
            }, {
                "id": "HSAG29",
                "name": "Livestock and Foreign Agriculture"
            }, {
                "id": "HSAG14",
                "name": "Biotechnology, Horticulture, and Research"
            }, {
                "id": "HSAG03",
                "name": "Nutrition"
            }]
        }, {
            "id": "HSAP",
            "name": "Committee on Appropriations",
            "url": "http://appropriations.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSAP.json",
            "chair": "Rodney Frelinghuysen",
            "chair_id": "F000372",
            "chair_party": "R",
            "chair_state": "NJ",
            "chair_uri": "https://api.propublica.org/congress/v1/members/F000372.json",
            "ranking_member_id": "L000480",
            "subcommittees": [{
                "id": "HSAP01",
                "name": "Agriculture, Rural Development, Food and Drug Administration, and Related Agencies"
            }, {
                "id": "HSAP19",
                "name": "Commerce, Justice, Science, and Related Agencies"
            }, {
                "id": "HSAP02",
                "name": "Defense"
            }, {
                "id": "HSAP10",
                "name": "Energy and Water Development, and Related Agencies"
            }, {
                "id": "HSAP23",
                "name": "Financial Services and General Government"
            }, {
                "id": "HSAP15",
                "name": "Homeland Security"
            }, {
                "id": "HSAP06",
                "name": "Interior, Environment, and Related Agencies"
            }, {
                "id": "HSAP07",
                "name": "Labor, Health and Human Services, Education, and Related Agencies"
            }, {
                "id": "HSAP24",
                "name": "Legislative Branch"
            }, {
                "id": "HSAP18",
                "name": "Military Construction, Veterans Affairs, and Related Agencies"
            }, {
                "id": "HSAP04",
                "name": "State, Foreign Operations, and Related Programs"
            }, {
                "id": "HSAP20",
                "name": "Transportation, and Housing and Urban Development, and Related Agencies"
            }]
        }, {
            "id": "HSAS",
            "name": "Committee on Armed Services",
            "url": "http://armedservices.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSAS.json",
            "chair": "William M. Thornberry",
            "chair_id": "T000238",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/T000238.json",
            "ranking_member_id": "S000510",
            "subcommittees": [{
                "id": "HSAS25",
                "name": "Tactical Air and Land Forces"
            }, {
                "id": "HSAS02",
                "name": "Military Personnel"
            }, {
                "id": "HSAS06",
                "name": "Oversight and Investigations"
            }, {
                "id": "HSAS03",
                "name": "Readiness"
            }, {
                "id": "HSAS28",
                "name": "Seapower and Projection Forces"
            }, {
                "id": "HSAS29",
                "name": "Strategic Forces"
            }, {
                "id": "HSAS26",
                "name": "Emerging Threats and Capabilities"
            }]
        }, {
            "id": "HSED",
            "name": "Committee on Education and the Workforce",
            "url": "http://edworkforce.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSED.json",
            "chair": "Virginia Foxx",
            "chair_id": "F000450",
            "chair_party": "R",
            "chair_state": "NC",
            "chair_uri": "https://api.propublica.org/congress/v1/members/F000450.json",
            "ranking_member_id": "S000185",
            "subcommittees": [{
                "id": "HSED14",
                "name": "Early Childhood, Elementary, and Secondary Education"
            }, {
                "id": "HSED02",
                "name": "Health, Employment, Labor, and Pensions"
            }, {
                "id": "HSED13",
                "name": "Higher Education and Workforce Development"
            }, {
                "id": "HSED10",
                "name": "Workforce Protections"
            }]
        }, {
            "id": "HSIF",
            "name": "Committee on Energy and Commerce",
            "url": "http://energycommerce.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSIF.json",
            "chair": "Greg Walden",
            "chair_id": "W000791",
            "chair_party": "R",
            "chair_state": "OR",
            "chair_uri": "https://api.propublica.org/congress/v1/members/W000791.json",
            "ranking_member_id": "P000034",
            "subcommittees": [{
                "id": "HSIF17",
                "name": "Digital Commerce and Consumer Protection"
            }, {
                "id": "HSIF16",
                "name": "Communications and Technology"
            }, {
                "id": "HSIF03",
                "name": "Energy"
            }, {
                "id": "HSIF14",
                "name": "Health"
            }, {
                "id": "HSIF02",
                "name": "Oversight and Investigations"
            }, {
                "id": "HSIF18",
                "name": "Environment"
            }]
        }, {
            "id": "HSBA",
            "name": "Committee on Financial Services",
            "url": "http://financialservices.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSBA.json",
            "chair": "Jeb Hensarling",
            "chair_id": "H001036",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/H001036.json",
            "ranking_member_id": "W000187",
            "subcommittees": [{
                "id": "HSBA16",
                "name": "Capital Markets, Securities, and Investment"
            }, {
                "id": "HSBA15",
                "name": "Financial Institutions and Consumer Credit"
            }, {
                "id": "HSBA04",
                "name": "Housing and Insurance"
            }, {
                "id": "HSBA20",
                "name": "Monetary Policy and Trade"
            }, {
                "id": "HSBA09",
                "name": "Oversight and Investigations"
            }, {
                "id": "HSBA01",
                "name": "Terrorism and Illicit Finance"
            }]
        }, {
            "id": "HSFA",
            "name": "Committee on Foreign Affairs",
            "url": "http://foreignaffairs.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSFA.json",
            "chair": "Edward  Royce",
            "chair_id": "R000487",
            "chair_party": "R",
            "chair_state": "CA",
            "chair_uri": "https://api.propublica.org/congress/v1/members/R000487.json",
            "ranking_member_id": "E000179",
            "subcommittees": [{
                "id": "HSFA16",
                "name": "Africa, Global Health, Global Human Rights, and International Organizations"
            }, {
                "id": "HSFA05",
                "name": "Asia and the Pacific"
            }, {
                "id": "HSFA14",
                "name": "Europe, Eurasia, and Emerging Threats"
            }, {
                "id": "HSFA18",
                "name": "Terrorism, Nonproliferation, and Trade"
            }, {
                "id": "HSFA13",
                "name": "The Middle East and North Africa"
            }, {
                "id": "HSFA07",
                "name": "The Western Hemisphere"
            }]
        }, {
            "id": "HSHM",
            "name": "Committee on Homeland Security",
            "url": "http://homeland.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSHM.json",
            "chair": "Michael McCaul",
            "chair_id": "M001157",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/M001157.json",
            "ranking_member_id": "T000193",
            "subcommittees": [{
                "id": "HSHM11",
                "name": "Border and Maritime Security"
            }, {
                "id": "HSHM12",
                "name": "Emergency Preparedness, Response, and Communications"
            }, {
                "id": "HSHM08",
                "name": "Cybersecurity and Infrastructure Protection"
            }, {
                "id": "HSHM05",
                "name": "Counterterrorism and Intelligence"
            }, {
                "id": "HSHM09",
                "name": "Oversight and Management Efficiency"
            }, {
                "id": "HSHM07",
                "name": "Transportation and Protective Security"
            }]
        }, {
            "id": "HSII",
            "name": "Committee on Natural Resources",
            "url": "http://naturalresources.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSII.json",
            "chair": "Rob Bishop",
            "chair_id": "B001250",
            "chair_party": "R",
            "chair_state": "UT",
            "chair_uri": "https://api.propublica.org/congress/v1/members/B001250.json",
            "ranking_member_id": "G000551",
            "subcommittees": [{
                "id": "HSII06",
                "name": "Energy and Mineral Resources"
            }, {
                "id": "HSII10",
                "name": "Federal Lands"
            }, {
                "id": "HSII13",
                "name": "Water, Power and Oceans"
            }, {
                "id": "HSII22",
                "name": "Fisheries, Wildlife, Oceans and Insular Affairs"
            }, {
                "id": "HSII24",
                "name": "Indian, Insular and Alaska Native Affairs"
            }, {
                "id": "HSII15",
                "name": "Oversight and Investigations"
            }]
        }, {
            "id": "HSGO",
            "name": "Committee on Oversight and Government Reform",
            "url": "http://oversight.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSGO.json",
            "chair": "Jason Chaffetz",
            "chair_id": "C001076",
            "chair_party": "R",
            "chair_state": "UT",
            "chair_uri": "https://api.propublica.org/congress/v1/members/C001076.json",
            "ranking_member_id": "C000984",
            "subcommittees": [{
                "id": "HSGO25",
                "name": "Information Technology"
            }, {
                "id": "HSGO24",
                "name": "Government Operations"
            }, {
                "id": "HSGO06",
                "name": "National Security"
            }, {
                "id": "HSGO27",
                "name": "Health Care, Benefits, and Administrative Rules"
            }, {
                "id": "HSGO28",
                "name": "The Interior, Energy and Environment"
            }, {
                "id": "HSGO29",
                "name": "Intergovernmental Affairs"
            }]
        }, {
            "id": "HSRU",
            "name": "Committee on Rules",
            "url": "http://rules.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSRU.json",
            "chair": "Pete Sessions",
            "chair_id": "S000250",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/S000250.json",
            "ranking_member_id": "S000480",
            "subcommittees": [{
                "id": "HSRU02",
                "name": "Legislative and Budget Process"
            }, {
                "id": "HSRU04",
                "name": "Rules and Organization of the House"
            }]
        }, {
            "id": "HSSY",
            "name": "Committee on Science, Space, and Technology",
            "url": "http://science.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSSY.json",
            "chair": "Lamar Smith",
            "chair_id": "S000583",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/S000583.json",
            "ranking_member_id": "J000126",
            "subcommittees": [{
                "id": "HSSY20",
                "name": "Energy"
            }, {
                "id": "HSSY21",
                "name": "Oversight"
            }, {
                "id": "HSSY16",
                "name": "Space"
            }, {
                "id": "HSSY18",
                "name": "Environment"
            }, {
                "id": "HSSY15",
                "name": "Research and Technology"
            }]
        }, {
            "id": "HSSM",
            "name": "Committee on Small Business",
            "url": "http://smallbusiness.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSSM.json",
            "chair": "Steven J. Chabot",
            "chair_id": "C000266",
            "chair_party": "R",
            "chair_state": "OH",
            "chair_uri": "https://api.propublica.org/congress/v1/members/C000266.json",
            "ranking_member_id": "V000081",
            "subcommittees": [{
                "id": "HSSM23",
                "name": "Contracting and Workforce"
            }, {
                "id": "HSSM24",
                "name": "Investigations, Oversight and Regulations"
            }, {
                "id": "HSSM25",
                "name": "Agriculture, Energy and Trade"
            }, {
                "id": "HSSM26",
                "name": "Health and Technology"
            }, {
                "id": "HSSM27",
                "name": "Economic Growth, Tax and Capital Access"
            }]
        }, {
            "id": "HSSO",
            "name": "Committee on Standards of Official Conduct",
            "url": "http://ethics.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSSO.json",
            "chair": "Susan Brooks",
            "chair_id": "B001284",
            "chair_party": "R",
            "chair_state": "IN",
            "chair_uri": "https://api.propublica.org/congress/v1/members/B001284.json",
            "ranking_member_id": "D000610",
            "subcommittees": []
        }, {
            "id": "HSBU",
            "name": "Committee on the Budget",
            "url": "http://budget.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSBU.json",
            "chair": "Diane Black",
            "chair_id": "B001273",
            "chair_party": "R",
            "chair_state": "TN",
            "chair_uri": "https://api.propublica.org/congress/v1/members/B001273.json",
            "ranking_member_id": "Y000062",
            "subcommittees": []
        }, {
            "id": "HSJU",
            "name": "Committee on the Judiciary",
            "url": "http://judiciary.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSJU.json",
            "chair": "Robert W. Goodlatte",
            "chair_id": "G000289",
            "chair_party": "R",
            "chair_state": "VA",
            "chair_uri": "https://api.propublica.org/congress/v1/members/G000289.json",
            "ranking_member_id": "C000714",
            "subcommittees": [{
                "id": "HSJU10",
                "name": "The Constitution and Civil Justice"
            }, {
                "id": "HSJU03",
                "name": "Courts, Intellectual Property, and the Internet"
            }, {
                "id": "HSJU08",
                "name": "Crime, Terrorism, Homeland Security, and Investigations"
            }, {
                "id": "HSJU01",
                "name": "Immigration and Border Security"
            }, {
                "id": "HSJU05",
                "name": "Regulatory Reform, Commercial and Antitrust Law"
            }]
        }, {
            "id": "HSPW",
            "name": "Committee on Transportation and Infrastructure",
            "url": "http://transportation.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSPW.json",
            "chair": "Bill Shuster",
            "chair_id": "S001154",
            "chair_party": "R",
            "chair_state": "PA",
            "chair_uri": "https://api.propublica.org/congress/v1/members/S001154.json",
            "ranking_member_id": "D000191",
            "subcommittees": [{
                "id": "HSPW05",
                "name": "Aviation"
            }, {
                "id": "HSPW07",
                "name": "Coast Guard and Maritime Transportation"
            }, {
                "id": "HSPW13",
                "name": "Economic Development, Public Buildings, and Emergency Management"
            }, {
                "id": "HSPW12",
                "name": "Highways and Transit"
            }, {
                "id": "HSPW14",
                "name": "Railroads, Pipelines, and Hazardous Materials"
            }, {
                "id": "HSPW02",
                "name": "Water Resources and Environment"
            }]
        }, {
            "id": "HSVR",
            "name": "Committee on Veterans&#39; Affairs",
            "url": "http://veterans.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSVR.json",
            "chair": "Phil Roe",
            "chair_id": "R000582",
            "chair_party": "R",
            "chair_state": "TN",
            "chair_uri": "https://api.propublica.org/congress/v1/members/R000582.json",
            "ranking_member_id": "W000799",
            "subcommittees": [{
                "id": "HSVR09",
                "name": "Disability Assistance and Memorial Affairs"
            }, {
                "id": "HSVR10",
                "name": "Economic Opportunity"
            }, {
                "id": "HSVR03",
                "name": "Health"
            }, {
                "id": "HSVR08",
                "name": "Oversight and Investigations"
            }]
        }, {
            "id": "HSWM",
            "name": "Committee on Ways and Means",
            "url": "http://waysandmeans.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HSWM.json",
            "chair": "Kevin Brady",
            "chair_id": "B000755",
            "chair_party": "R",
            "chair_state": "TX",
            "chair_uri": "https://api.propublica.org/congress/v1/members/B000755.json",
            "ranking_member_id": "N000015",
            "subcommittees": [{
                "id": "HSWM02",
                "name": "Health"
            }, {
                "id": "HSWM03",
                "name": "Human Resources"
            }, {
                "id": "HSWM06",
                "name": "Oversight"
            }, {
                "id": "HSWM05",
                "name": "Tax Policy"
            }, {
                "id": "HSWM01",
                "name": "Social Security"
            }, {
                "id": "HSWM04",
                "name": "Trade"
            }]
        }, {
            "id": "HLIG",
            "name": "Permanent Select Committee on Intelligence",
            "url": "http://intelligence.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HLIG.json",
            "chair": "Devin Nunes",
            "chair_id": "N000181",
            "chair_party": "R",
            "chair_state": "CA",
            "chair_uri": "https://api.propublica.org/congress/v1/members/N000181.json",
            "ranking_member_id": "S001150",
            "subcommittees": [{
                "id": "HLIG09",
                "name": "Oversight and Investigations"
            }, {
                "id": "HLIG05",
                "name": "Technical and Tactical Intelligence"
            }, {
                "id": "HLIG08",
                "name": "Terrorism, Human Intelligence, Analysis, and Counterintelligence"
            }, {
                "id": "HLIG01",
                "name": "Central Intelligence Agency"
            }, {
                "id": "HLIG02",
                "name": "National Security Agency and Cybersecurity"
            }, {
                "id": "HLIG03",
                "name": "Emerging Threats"
            }, {
                "id": "HLIG04",
                "name": "Department of Defense Intelligence and Overhead Architecture"
            }]
        }, {
            "id": "HLZI",
            "name": "Select Committee on Benghazi",
            "url": "http://benghazi.house.gov/",
            "api_uri": "https://api.propublica.org/congress/v1/115/house/committees/HLZI.json",
            "chair": "",
            "chair_id": "",
            "chair_party": "",
            "chair_state": "",
            "chair_uri": "",
            "ranking_member_id": "C000984",
            "subcommittees": []
        }]
    }]
}

To get a list of Senate or House committees or get the members of a particular committee, use the following URI structure. Optionally provide a committee’s ID (see below) retrieves that committee’s roster of members.

HTTP Request

GET https://api.propublica.org/congress/v1/{congress}/{chamber}/committees/{committee-id}.json

URL Parameters

Parameter Description
congress 110-115
chamber house or senate
committee-id Optional committee abbreviation, for example HSAG. Use the full committees response to find abbreviations.

Errors

The ProPublica Congress API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request is improperly formed
403 Forbidden – Your request did not include an authorization header
404 Not Found – The specified record(s) could not be found
406 Not Acceptable – You requested a format that isn’t json or xml
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – The service is currently not working. Please try again later.