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 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 in the public domain.

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/114/house/members.json"
  -H "X-API-Key: PROPUBLICA_API_KEY"

The above command returns JSON structured like this:

{
  "status": "OK",
  "copyright": "Copyright (c) 2016 ProPublica Inc.  All Rights Reserved.",
  "results": [
    {
      "congress": "114",
      "chamber": "Senate",
      "num_results": "100",
      "offset": "0",
      "members": [
        {
          "id": "A000360",
          "thomas_id": "1695",
          "api_uri": "https://api.propublica.org/congress/v1/members/A000360.json",
          "first_name": "Lamar",
          "middle_name": "",
          "last_name": "Alexander",
          "party": "R",
          "twitter_account": "SenAlexander",
          "facebook_account": "senatorlamaralexander",
          "facebook_id": "89927603836",
          "url": "http://www.alexander.senate.gov",
          "rss_url": "http://www.alexander.senate.gov/public/?a=RSS.Feed",
          "domain": "",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "13",
          "next_election": "2014",
          "total_votes": "353",
          "missed_votes": "12",
          "total_present": "0",
          "state": "TN",
          "missed_votes_pct": "3.40",
          "votes_with_party_pct": "86.51"
        },
        {
          "id": "A000368",
          "thomas_id": "2075",
          "api_uri": "https://api.propublica.org/congress/v1/members/A000368.json",
          "first_name": "Kelly",
          "middle_name": null,
          "last_name": "Ayotte",
          "party": "R",
          "twitter_account": "KellyAyotte",
          "facebook_account": "kellyayottenh",
          "facebook_id": "123436097729198",
          "url": "http://www.ayotte.senate.gov",
          "rss_url": "http://www.ayotte.senate.gov/rss/",
          "domain": "",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "5",
          "next_election": "2016",
          "total_votes": "353",
          "missed_votes": "2",
          "total_present": "0",
          "state": "NH",
          "missed_votes_pct": "0.57",
          "votes_with_party_pct": "79.77"
        },
        {
          "id": "B000575",
          "thomas_id": "1464",
          "api_uri": "https://api.propublica.org/congress/v1/members/B000575.json",
          "first_name": "Roy",
          "middle_name": "",
          "last_name": "Blunt",
          "party": "R",
          "twitter_account": "RoyBlunt",
          "facebook_account": "SenatorBlunt",
          "facebook_id": "142473042477322",
          "url": "http://www.blunt.senate.gov",
          "rss_url": "http://www.blunt.senate.gov/public/?a=RSS.Feed",
          "domain": "",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "5",
          "next_election": "2016",
          "total_votes": "353",
          "missed_votes": "15",
          "total_present": "0",
          "state": "MO",
          "missed_votes_pct": "4.25",
          "votes_with_party_pct": "90.53"
        },
        {
          "id": "B000711",
          "thomas_id": "116",
          "api_uri": "https://api.propublica.org/congress/v1/members/B000711.json",
          "first_name": "Barbara",
          "middle_name": null,
          "last_name": "Boxer",
          "party": "D",
          "twitter_account": "SenatorBoxer",
          "facebook_account": "senatorboxer",
          "facebook_id": "116513005087055",
          "url": "http://www.boxer.senate.gov",
          "rss_url": "http://www.boxer.senate.gov/atom.xml",
          "domain": "www.boxer.senate.gov",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "23",
          "next_election": "2016",
          "total_votes": "353",
          "missed_votes": "42",
          "total_present": "0",
          "state": "CA",
          "missed_votes_pct": "11.90",
          "votes_with_party_pct": "96.46"
        },
        ...
        {
          "id": "W000805",
          "thomas_id": "1897",
          "api_uri": "https://api.propublica.org/congress/v1/members/W000805.json",
          "first_name": "Mark",
          "middle_name": null,
          "last_name": "Warner",
          "party": "D",
          "twitter_account": "MarkWarner",
          "facebook_account": "MarkRWarner",
          "facebook_id": "7935122852",
          "url": "http://www.warner.senate.gov",
          "rss_url": "http://www.warner.senate.gov/public/?a=RSS.TaggedFeed&Type=PressReleases",
          "domain": "www.warner.senate.gov/public/",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "7",
          "next_election": "2014",
          "total_votes": "353",
          "missed_votes": "18",
          "total_present": "0",
          "state": "VA",
          "missed_votes_pct": "5.10",
          "votes_with_party_pct": "86.27"
        },
        {
          "id": "W000817",
          "thomas_id": "2182",
          "api_uri": "https://api.propublica.org/congress/v1/members/W000817.json",
          "first_name": "Elizabeth",
          "middle_name": null,
          "last_name": "Warren",
          "party": "D",
          "twitter_account": "SenWarren",
          "facebook_account": "senatorelizabethwarren",
          "facebook_id": "131559043673264",
          "url": "http://www.warren.senate.gov",
          "rss_url": "http://www.warren.senate.gov/rss/",
          "domain": "www.warren.senate.gov",
          "dw_nominate": "",
          "ideal_point": "",
          "seniority": "3",
          "next_election": "2018",
          "total_votes": "353",
          "missed_votes": "0",
          "total_present": "0",
          "state": "MA",
          "missed_votes_pct": "0.00",
          "votes_with_party_pct": "94.33"
        }
      ]
    }
  ]
}

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) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "member_id": "A000360",
      "first_name": "Lamar",
      "middle_name": "",
      "last_name": "Alexander",
      "date_of_birth": "1940-07-03",
      "gender": "M",
      "url": "http://www.alexander.senate.gov",
      "times_topics_url": "http://topics.nytimes.com/top/reference/timestopics/people/a/lamar_alexander/index.html",
      "times_tag": "",
      "govtrack_id": "300002",
      "cspan_id": "5",
      "icpsr_id": "40304",
      "thomas_id": "1695",
      "twitter_account": "SenAlexander",
      "facebook_account": "senatorlamaralexander",
      "facebook_id": "89927603836",
      "youtube_account": "lamaralexander",
      "rss_url": "http://www.alexander.senate.gov/public/?a=RSS.Feed",
      "domain": "",
      "current_party": "R",
      "most_recent_vote": "2016-04-11",
      "roles": [
        {
          "congress": "114",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "13",
          "district": "N/A",
          "start_date": "2015-01-06",
          "end_date": "2017-01-03",
          "bills_sponsored": "35",
          "bills_cosponsored": "120",
          "missed_votes_pct": "3.40",
          "votes_with_party_pct": "86.51",
          "committees": []
        },
        {
          "congress": "113",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "11",
          "district": "N/A",
          "start_date": "2013-01-03",
          "end_date": "2015-01-02",
          "bills_sponsored": "27",
          "bills_cosponsored": "156",
          "missed_votes_pct": "6.70",
          "votes_with_party_pct": "85.97",
          "committees": [
            {
              "name": "Committee on Rules and Administration",
              "code": "SSRA",
              "api_uri": "https://api.propublica.org/congress/v1/113/senate/committees/SSRA.json",
              "rank_in_party": "5",
              "begin_date": "2013-01-03",
              "end_date": "2015-01-03"
            },
            {
              "name": "Committee on Energy and Natural Resources",
              "code": "SSEG",
              "api_uri": "https://api.propublica.org/congress/v1/113/senate/committees/SSEG.json",
              "rank_in_party": "8",
              "begin_date": "2013-01-03",
              "end_date": "2015-01-03"
            },
            {
              "name": "Committee on Health, Education, Labor, and Pensions",
              "code": "SSHR",
              "api_uri": "https://api.propublica.org/congress/v1/113/senate/committees/SSHR.json",
              "rank_in_party": "1",
              "begin_date": "2013-01-03",
              "end_date": "2015-01-03"
            },
            {
              "name": "Committee on Appropriations",
              "code": "SSAP",
              "api_uri": "https://api.propublica.org/congress/v1/113/senate/committees/SSAP.json",
              "rank_in_party": "4",
              "begin_date": "2013-01-03",
              "end_date": "2015-01-03"
            }
          ]
        },
        {
          "congress": "112",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "9",
          "district": "N/A",
          "start_date": "2011-01-04",
          "end_date": "2013-01-03",
          "bills_sponsored": "10",
          "bills_cosponsored": "193",
          "missed_votes_pct": "3.29",
          "votes_with_party_pct": "86.84",
          "committees": [
            {
              "name": "Joint Committee on Printing",
              "code": "JSPR",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/JSPR.json",
              "rank_in_party": "1",
              "begin_date": "2011-01-07",
              "end_date": "2013-01-03"
            },
            {
              "name": "Joint Committee on the Library",
              "code": "JSLC",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/JSLC.json",
              "rank_in_party": "2",
              "begin_date": "2011-01-07",
              "end_date": "2013-01-03"
            },
            {
              "name": "Committee on Appropriations",
              "code": "SSAP",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/SSAP.json",
              "rank_in_party": "5",
              "begin_date": "2011-01-05",
              "end_date": "2013-01-03"
            },
            {
              "name": "Committee on Environment and Public Works",
              "code": "SSEV",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/SSEV.json",
              "rank_in_party": "6",
              "begin_date": "2011-01-05",
              "end_date": "2013-01-03"
            },
            {
              "name": "Committee on Health, Education, Labor, and Pensions",
              "code": "SSHR",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/SSHR.json",
              "rank_in_party": "2",
              "begin_date": "2011-01-05",
              "end_date": "2013-01-03"
            },
            {
              "name": "Committee on Rules and Administration",
              "code": "SSRA",
              "api_uri": "https://api.propublica.org/congress/v1/112/senate/committees/SSRA.json",
              "rank_in_party": "1",
              "begin_date": "2011-01-05",
              "end_date": "2013-01-03"
            }
          ]
        },
        {
          "congress": "111",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "7",
          "district": "N/A",
          "start_date": "2009-01-06",
          "end_date": "2011-01-03",
          "bills_sponsored": "29",
          "bills_cosponsored": "149",
          "missed_votes_pct": "1.33",
          "votes_with_party_pct": "84.28",
          "committees": [
            {
              "name": "Committee on Appropriations",
              "code": "SSAP",
              "api_uri": "https://api.propublica.org/congress/v1/111/senate/committees/SSAP.json",
              "rank_in_party": "9",
              "begin_date": "2009-01-21",
              "end_date": "2011-01-03"
            },
            {
              "name": "Committee on the Budget",
              "code": "SSBU",
              "api_uri": "https://api.propublica.org/congress/v1/111/senate/committees/SSBU.json",
              "rank_in_party": "10",
              "begin_date": "2009-01-21",
              "end_date": "2011-01-03"
            },
            {
              "name": "Committee on Environment and Public Works",
              "code": "SSEV",
              "api_uri": "https://api.propublica.org/congress/v1/111/senate/committees/SSEV.json",
              "rank_in_party": "7",
              "begin_date": "2009-01-21",
              "end_date": "2011-01-03"
            },
            {
              "name": "Committee on Health, Education, Labor, and Pensions",
              "code": "SSHR",
              "api_uri": "https://api.propublica.org/congress/v1/111/senate/committees/SSHR.json",
              "rank_in_party": "3",
              "begin_date": "2009-01-21",
              "end_date": "2011-01-03"
            },
            {
              "name": "Committee on Rules and Administration",
              "code": "SSRA",
              "api_uri": "https://api.propublica.org/congress/v1/111/senate/committees/SSRA.json",
              "rank_in_party": "6",
              "begin_date": "2009-01-21",
              "end_date": "2011-01-03"
            }
          ]
        },
        {
          "congress": "110",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "5",
          "district": "N/A",
          "start_date": "2007-01-04",
          "end_date": "2009-01-03",
          "bills_sponsored": "22",
          "bills_cosponsored": "197",
          "missed_votes_pct": "4.41",
          "votes_with_party_pct": "87.74",
          "committees": [
            {
              "name": "Committee on Appropriations",
              "code": "SSAP",
              "api_uri": "https://api.propublica.org/congress/v1/110/senate/committees/SSAP.json",
              "rank_in_party": "14",
              "begin_date": "2007-01-12",
              "end_date": "2009-01-03"
            },
            {
              "name": "Committee on Environment and Public Works",
              "code": "SSEV",
              "api_uri": "https://api.propublica.org/congress/v1/110/senate/committees/SSEV.json",
              "rank_in_party": "7",
              "begin_date": "2007-01-12",
              "end_date": "2009-01-03"
            },
            {
              "name": "Committee on Health, Education, Labor, and Pensions",
              "code": "SSHR",
              "api_uri": "https://api.propublica.org/congress/v1/110/senate/committees/SSHR.json",
              "rank_in_party": "3",
              "begin_date": "2007-01-12",
              "end_date": "2009-01-03"
            },
            {
              "name": "Committee on Rules and Administration",
              "code": "SSRA",
              "api_uri": "https://api.propublica.org/congress/v1/110/senate/committees/SSRA.json",
              "rank_in_party": "9",
              "begin_date": "2007-01-12",
              "end_date": "2009-01-03"
            }
          ]
        },
        {
          "congress": "109",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "3",
          "district": "N/A",
          "start_date": "2005-01-04",
          "end_date": "2007-01-03",
          "bills_sponsored": "26",
          "bills_cosponsored": "181",
          "missed_votes_pct": "2.33",
          "votes_with_party_pct": "92.38",
          "committees": []
        },
        {
          "congress": "108",
          "chamber": "Senate",
          "title": "Senator, 2nd Class",
          "state": "TN",
          "party": "R",
          "seniority": "1",
          "district": "N/A",
          "start_date": "2003-01-07",
          "end_date": "2005-01-03",
          "bills_sponsored": "16",
          "bills_cosponsored": "123",
          "missed_votes_pct": "1.93",
          "votes_with_party_pct": "95.92",
          "committees": []
        }
      ]
    }
  ]
}

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) 2016 Pro Publica Inc.  All Rights Reserved.",
  "results": [
    {
      "num_results": "20",
      "offset": "0",
      "members": [
        {
          "id": "L000585",
          "first_name": "Darin",
          "middle_name": "M.",
          "last_name": "LaHood",
          "party": "R",
          "chamber": "House",
          "state": "IL",
          "district": "18",
          "start_date": "2015-09-17"
        },
        {
          "id": "K000388",
          "first_name": "Trent",
          "middle_name": "",
          "last_name": "Kelly",
          "party": "R",
          "chamber": "House",
          "state": "MS",
          "district": "1",
          "start_date": "2015-06-09"
        },
        {
          "id": "D000625",
          "first_name": "Daniel",
          "middle_name": "M.",
          "last_name": "Donovan",
          "party": "R",
          "chamber": "House",
          "state": "NY",
          "district": "11",
          "start_date": "2015-05-12"
        },
        {
          "id": "C001075",
          "first_name": "Bill",
          "middle_name": "",
          "last_name": "Cassidy",
          "party": "R",
          "chamber": "Senate",
          "state": "LA",
          "start_date": "2015-01-06"
        },
        {
          "id": "C001047",
          "first_name": "Shelley",
          "middle_name": "Moore",
          "last_name": "Capito",
          "party": "R",
          "chamber": "Senate",
          "state": "WV",
          "start_date": "2015-01-06"
        },
        {
          "id": "A000372",
          "first_name": "Rick",
          "middle_name": "",
          "last_name": "Allen",
          "party": "R",
          "chamber": "House",
          "state": "GA",
          "district": "12",
          "start_date": "2015-01-06"
        },
        {
          "id": "B001294",
          "first_name": "Rod",
          "middle_name": "",
          "last_name": "Blum",
          "party": "R",
          "chamber": "House",
          "state": "IA",
          "district": "1",
          "start_date": "2015-01-06"
        },
        {
          "id": "B001295",
          "first_name": "Mike",
          "middle_name": "",
          "last_name": "Bost",
          "party": "R",
          "chamber": "House",
          "state": "IL",
          "district": "12",
          "start_date": "2015-01-06"
        },
        {
          "id": "D000623",
          "first_name": "Mark",
          "middle_name": "",
          "last_name": "DeSaulnier",
          "party": "D",
          "chamber": "House",
          "state": "CA",
          "district": "11",
          "start_date": "2015-01-06"
        },
        {
          "id": "G000570",
          "first_name": "Frank",
          "middle_name": "",
          "last_name": "Guinta",
          "party": "R",
          "chamber": "House",
          "state": "NH",
          "district": "1",
          "start_date": "2015-01-06"
        },
        {
          "id": "K000386",
          "first_name": "John",
          "middle_name": "",
          "last_name": "Katko",
          "party": "R",
          "chamber": "House",
          "state": "NY",
          "district": "24",
          "start_date": "2015-01-06"
        },
        {
          "id": "K000387",
          "first_name": "Steve",
          "middle_name": "",
          "last_name": "Knight",
          "party": "R",
          "chamber": "House",
          "state": "CA",
          "district": "25",
          "start_date": "2015-01-06"
        },
        {
          "id": "M001197",
          "first_name": "Martha",
          "middle_name": "",
          "last_name": "McSally",
          "party": "R",
          "chamber": "House",
          "state": "AZ",
          "district": "2",
          "start_date": "2015-01-06"
        },
        {
          "id": "P000610",
          "first_name": "Stacey",
          "middle_name": "",
          "last_name": "Plaskett",
          "party": "D",
          "chamber": "House",
          "state": "VI",
          "district": "79",
          "start_date": "2015-01-06"
        },
        {
          "id": "P000611",
          "first_name": "Bruce",
          "middle_name": "",
          "last_name": "Poliquin",
          "party": "R",
          "chamber": "House",
          "state": "ME",
          "district": "2",
          "start_date": "2015-01-06"
        },
        {
          "id": "T000474",
          "first_name": "Norma",
          "middle_name": "",
          "last_name": "Torres",
          "party": "D",
          "chamber": "House",
          "state": "CA",
          "district": "35",
          "start_date": "2015-01-06"
        },
        {
          "id": "Z000017",
          "first_name": "Lee",
          "middle_name": "",
          "last_name": "Zeldin",
          "party": "R",
          "chamber": "House",
          "state": "NY",
          "district": "1",
          "start_date": "2015-01-06"
        },
        {
          "id": "R000601",
          "first_name": "John",
          "middle_name": "",
          "last_name": "Ratcliffe",
          "party": "R",
          "chamber": "House",
          "state": "TX",
          "district": "4",
          "start_date": "2015-01-06"
        },
        {
          "id": "W000821",
          "first_name": "Bruce",
          "middle_name": "",
          "last_name": "Westerman",
          "party": "R",
          "chamber": "House",
          "state": "AR",
          "district": "4",
          "start_date": "2015-01-06"
        },
        {
          "id": "S001197",
          "first_name": "Ben",
          "middle_name": "",
          "last_name": "Sasse",
          "party": "R",
          "chamber": "Senate",
          "state": "NE",
          "start_date": "2015-01-06"
        }
      ]
    }
  ]
}

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) 2016 Pro Publica 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": "19",
      "next_election": "2014",
      "api_url": "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": "9",
      "next_election": "2016",
      "api_url": "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/114/house/members/leaving.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": "44",
      "offset": "0",
      "members": [
        {
          "id": "M001144",
          "api_uri": "https://api.propublica.org/congress/v1/members/M001144.json",
          "first_name": "Jeff",
          "middle_name": "",
          "last_name": "Miller",
          "party": "R",
          "state": "FL",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on March 10, 2016."
        },
        {
          "id": "F000458",
          "api_uri": "https://api.propublica.org/congress/v1/members/F000458.json",
          "first_name": "Stephen",
          "middle_name": "",
          "last_name": "Fincher",
          "party": "R",
          "state": "TN",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Feb. 1, 2016."
        },
        {
          "id": "R000587",
          "api_uri": "https://api.propublica.org/congress/v1/members/R000587.json",
          "first_name": "Reid",
          "middle_name": "",
          "last_name": "Ribble",
          "party": "R",
          "state": "WI",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 31, 2016."
        },
        {
          "id": "R000589",
          "api_uri": "https://api.propublica.org/congress/v1/members/R000589.json",
          "first_name": "Scott",
          "middle_name": "",
          "last_name": "Rigell",
          "party": "R",
          "state": "VA",
          "district": "2",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 14, 2016."
        },
        {
          "id": "W000796",
          "api_uri": "https://api.propublica.org/congress/v1/members/W000796.json",
          "first_name": "Lynn",
          "middle_name": "",
          "last_name": "Westmoreland",
          "party": "R",
          "state": "GA",
          "district": "3",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 7, 2016."
        },
        {
          "id": "I000057",
          "api_uri": "https://api.propublica.org/congress/v1/members/I000057.json",
          "first_name": "Steve",
          "middle_name": "",
          "last_name": "Israel",
          "party": "D",
          "state": "NY",
          "district": "3",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 5, 2016."
        },
        {
          "id": "M000404",
          "api_uri": "https://api.propublica.org/congress/v1/members/M000404.json",
          "first_name": "Jim",
          "middle_name": "",
          "last_name": "McDermott",
          "party": "D",
          "state": "WA",
          "district": "7",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 4, 2016."
        },
        {
          "id": "H001060",
          "api_uri": "https://api.propublica.org/congress/v1/members/H001060.json",
          "first_name": "Robert",
          "middle_name": "",
          "last_name": "Hurt",
          "party": "R",
          "state": "VA",
          "district": "5",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Dec. 23, 2015."
        },
        {
          "id": "H001051",
          "api_uri": "https://api.propublica.org/congress/v1/members/H001051.json",
          "first_name": "Richard",
          "middle_name": "",
          "last_name": "Hanna",
          "party": "R",
          "state": "NY",
          "district": "22",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Dec. 20, 2015."
        },
        {
          "id": "B001255",
          "api_uri": "https://api.propublica.org/congress/v1/members/B001255.json",
          "first_name": "Charles",
          "middle_name": "",
          "last_name": "Boustany Jr.",
          "party": "R",
          "state": "LA",
          "district": "3",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "F000456",
          "api_uri": "https://api.propublica.org/congress/v1/members/F000456.json",
          "first_name": "John",
          "middle_name": "",
          "last_name": "Fleming",
          "party": "R",
          "state": "LA",
          "district": "4",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "C001083",
          "api_uri": "https://api.propublica.org/congress/v1/members/C001083.json",
          "first_name": "John",
          "middle_name": "",
          "last_name": "Carney",
          "party": "D",
          "state": "DE",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for governor."
        },
        {
          "id": "H000636",
          "api_uri": "https://api.propublica.org/congress/v1/members/H000636.json",
          "first_name": "Rubén",
          "middle_name": "",
          "last_name": "Hinojosa",
          "party": "D",
          "state": "TX",
          "district": "15",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 13, 2015."
        },
        {
          "id": "F000030",
          "api_uri": "https://api.propublica.org/congress/v1/members/F000030.json",
          "first_name": "Sam",
          "middle_name": "",
          "last_name": "Farr",
          "party": "D",
          "state": "CA",
          "district": "20",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 12, 2015."
        },
        {
          "id": "L000571",
          "api_uri": "https://api.propublica.org/congress/v1/members/L000571.json",
          "first_name": "Cynthia",
          "middle_name": "M.",
          "last_name": "Lummis",
          "party": "R",
          "state": "WY",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 12, 2015."
        },
        {
          "id": "P000373",
          "api_uri": "https://api.propublica.org/congress/v1/members/P000373.json",
          "first_name": "Joe",
          "middle_name": "",
          "last_name": "Pitts",
          "party": "R",
          "state": "PA",
          "district": "16",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 6, 2015."
        },
        {
          "id": "N000185",
          "api_uri": "https://api.propublica.org/congress/v1/members/N000185.json",
          "first_name": "Richard",
          "middle_name": "",
          "last_name": "Nugent",
          "party": "R",
          "state": "FL",
          "district": "11",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 2, 2015."
        },
        {
          "id": "R000053",
          "api_uri": "https://api.propublica.org/congress/v1/members/R000053.json",
          "first_name": "Charles",
          "middle_name": "B.",
          "last_name": "Rangel",
          "party": "D",
          "state": "NY",
          "district": "13",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Oct. 30, 2015."
        },
        {
          "id": "W000413",
          "api_uri": "https://api.propublica.org/congress/v1/members/W000413.json",
          "first_name": "Edward",
          "middle_name": "",
          "last_name": "Whitfield",
          "party": "R",
          "state": "KY",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Sept. 29, 2015."
        },
        {
          "id": "B000589",
          "api_uri": "https://api.propublica.org/congress/v1/members/B000589.json",
          "first_name": "John",
          "middle_name": "A.",
          "last_name": "Boehner",
          "party": "R",
          "state": "OH",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2015-10-31",
          "status": "Left Congress",
          "note": "Announced resignation effective Oct. 31, 2015."
        },
        {
          "id": "B001271",
          "api_uri": "https://api.propublica.org/congress/v1/members/B001271.json",
          "first_name": "Dan",
          "middle_name": "",
          "last_name": "Benishek",
          "party": "R",
          "state": "MI",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Sept. 17, 2015."
        },
        {
          "id": "N000182",
          "api_uri": "https://api.propublica.org/congress/v1/members/N000182.json",
          "first_name": "Randy",
          "middle_name": "",
          "last_name": "Neugebauer",
          "party": "R",
          "state": "TX",
          "district": "19",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Sept. 17, 2015."
        },
        {
          "id": "K000363",
          "api_uri": "https://api.propublica.org/congress/v1/members/K000363.json",
          "first_name": "John",
          "middle_name": "",
          "last_name": "Kline",
          "party": "R",
          "state": "MN",
          "district": "2",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Sept. 3, 2015."
        },
        {
          "id": "J000296",
          "api_uri": "https://api.propublica.org/congress/v1/members/J000296.json",
          "first_name": "David",
          "middle_name": "W.",
          "last_name": "Jolly",
          "party": "R",
          "state": "FL",
          "district": "13",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "Y000064",
          "api_uri": "https://api.propublica.org/congress/v1/members/Y000064.json",
          "first_name": "Todd",
          "middle_name": "",
          "last_name": "Young",
          "party": "R",
          "state": "IN",
          "district": "9",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "G000556",
          "api_uri": "https://api.propublica.org/congress/v1/members/G000556.json",
          "first_name": "Alan",
          "middle_name": "",
          "last_name": "Grayson",
          "party": "D",
          "state": "FL",
          "district": "9",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "H001055",
          "api_uri": "https://api.propublica.org/congress/v1/members/H001055.json",
          "first_name": "Joe",
          "middle_name": "",
          "last_name": "Heck",
          "party": "R",
          "state": "NV",
          "district": "3",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "K000368",
          "api_uri": "https://api.propublica.org/congress/v1/members/K000368.json",
          "first_name": "Ann",
          "middle_name": "",
          "last_name": "Kirkpatrick",
          "party": "D",
          "state": "AZ",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "S000030",
          "api_uri": "https://api.propublica.org/congress/v1/members/S000030.json",
          "first_name": "Loretta",
          "middle_name": "",
          "last_name": "Sánchez",
          "party": "D",
          "state": "CA",
          "district": "46",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "S001188",
          "api_uri": "https://api.propublica.org/congress/v1/members/S001188.json",
          "first_name": "Marlin",
          "middle_name": "",
          "last_name": "Stutzman",
          "party": "R",
          "state": "IN",
          "district": "3",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "D000621",
          "api_uri": "https://api.propublica.org/congress/v1/members/D000621.json",
          "first_name": "Ron",
          "middle_name": "",
          "last_name": "DeSantis",
          "party": "R",
          "state": "FL",
          "district": "6",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "C001036",
          "api_uri": "https://api.propublica.org/congress/v1/members/C001036.json",
          "first_name": "Lois",
          "middle_name": "",
          "last_name": "Capps",
          "party": "D",
          "state": "CA",
          "district": "24",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on April 8, 2015."
        },
        {
          "id": "D000622",
          "api_uri": "https://api.propublica.org/congress/v1/members/D000622.json",
          "first_name": "Tammy",
          "middle_name": "",
          "last_name": "Duckworth",
          "party": "D",
          "state": "IL",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "M001191",
          "api_uri": "https://api.propublica.org/congress/v1/members/M001191.json",
          "first_name": "Patrick",
          "middle_name": "",
          "last_name": "Murphy",
          "party": "D",
          "state": "FL",
          "district": "18",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "S001179",
          "api_uri": "https://api.propublica.org/congress/v1/members/S001179.json",
          "first_name": "Aaron",
          "middle_name": "",
          "last_name": "Schock",
          "party": "R",
          "state": "IL",
          "district": "18",
          "begin_date": "2015-01-06",
          "end_date": "2015-03-31",
          "status": "Left Congress",
          "note": "Announced resignation effective March 31, 2015."
        },
        {
          "id": "E000290",
          "api_uri": "https://api.propublica.org/congress/v1/members/E000290.json",
          "first_name": "Donna",
          "middle_name": "",
          "last_name": "Edwards",
          "party": "D",
          "state": "MD",
          "district": "4",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "M001150",
          "api_uri": "https://api.propublica.org/congress/v1/members/M001150.json",
          "first_name": "Candice",
          "middle_name": "S.",
          "last_name": "Miller",
          "party": "R",
          "state": "MI",
          "district": "10",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on March 6, 2015."
        },
        {
          "id": "V000128",
          "api_uri": "https://api.propublica.org/congress/v1/members/V000128.json",
          "first_name": "Chris",
          "middle_name": "",
          "last_name": "Van Hollen",
          "party": "D",
          "state": "MD",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for Senate."
        },
        {
          "id": "H001063",
          "api_uri": "https://api.propublica.org/congress/v1/members/H001063.json",
          "first_name": "Janice",
          "middle_name": "",
          "last_name": "Hahn",
          "party": "D",
          "state": "CA",
          "district": "44",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for county supervisor."
        },
        {
          "id": "N000186",
          "api_uri": "https://api.propublica.org/congress/v1/members/N000186.json",
          "first_name": "Alan",
          "middle_name": "",
          "last_name": "Nunnelee",
          "party": "R",
          "state": "MS",
          "district": "1",
          "begin_date": "2015-01-06",
          "end_date": "2015-02-06",
          "status": "Left Congress",
          "note": "Died on Feb. 6, 2015."
        },
        {
          "id": "G000564",
          "api_uri": "https://api.propublica.org/congress/v1/members/G000564.json",
          "first_name": "Chris",
          "middle_name": "",
          "last_name": "Gibson",
          "party": "R",
          "state": "NY",
          "district": "19",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Jan. 6, 2015."
        },
        {
          "id": "G000569",
          "api_uri": "https://api.propublica.org/congress/v1/members/G000569.json",
          "first_name": "Mike",
          "middle_name": "",
          "last_name": "Grimm",
          "party": "R",
          "state": "NY",
          "district": "11",
          "begin_date": "2015-01-05",
          "end_date": "2015-01-05",
          "status": "Left Congress",
          "note": "Resigned from the House on Jan. 5, 2015."
        },
        {
          "id": "F000451",
          "api_uri": "https://api.propublica.org/congress/v1/members/F000451.json",
          "first_name": "Michael",
          "middle_name": "G.",
          "last_name": "Fitzpatrick",
          "party": "R",
          "state": "PA",
          "district": "8",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Retiring",
          "note": "Announced retirement on Nov. 10, 2014."
        },
        {
          "id": "P000596",
          "api_uri": "https://api.propublica.org/congress/v1/members/P000596.json",
          "first_name": "Pedro",
          "middle_name": "",
          "last_name": "Pierluisi",
          "party": "D",
          "state": "PR",
          "district": "80",
          "begin_date": "2015-01-06",
          "end_date": "2017-01-03",
          "status": "Seeking another office",
          "note": "Running for governor."
        }
      ]
    }
  ]
}

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) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": [
    {
      "member_id": "K000388",
      "total_votes": "100",
      "offset": "0",
      "votes": [
        {
          "member_id": "K000388",
          "chamber": "House",
          "congress": "114",
          "session": "2",
          "roll_call": "138",
          "bill": {},
          "description": "Condemning in the strongest terms the terrorist attacks in Brussels on March 22, 2016, which murdered more than 30 innocent people, and severely wounded many more",
          "question": "On Motion to Suspend the Rules and Agree",
          "date": "2016-03-23",
          "time": "11:18:00",
          "position": "Yes"
        },
        {
          "member_id": "K000388",
          "chamber": "House",
          "congress": "114",
          "session": "2",
          "roll_call": "137",
          "bill": {
            "number": "H R 2745",
            "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2745.json",
            "title": "Standard Merger and Acquisition Reviews Through Equal Rules Act of 2015",
            "latest_action": "Received in the Senate and Read twice and referred to the Committee on the Judiciary."
          },
          "description": "Standard Merger and Acquisition Reviews Through Equal Rules Act of 2015",
          "question": "On Passage",
          "date": "2016-03-23",
          "time": "11:06:00",
          "position": "Yes"
        },
        {
          "member_id": "K000388",
          "chamber": "House",
          "congress": "114",
          "session": "2",
          "roll_call": "136",
          "bill": {
            "number": "H R 2745",
            "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr2745.json",
            "title": "Standard Merger and Acquisition Reviews Through Equal Rules Act of 2015",
            "latest_action": "Received in the Senate and Read twice and referred to the Committee on the Judiciary."
          },
          "description": "Standard Merger and Acquisition Reviews Through Equal Rules Act of 2015",
          "question": "On Motion to Recommit with Instructions",
          "date": "2016-03-23",
          "time": "11:00:00",
          "position": "No"
        },
        {
          "member_id": "K000388",
          "chamber": "House",
          "congress": "114",
          "session": "2",
          "roll_call": "135",
          "bill": {
            "number": "H R 4336",
            "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr4336.json",
            "title": "To amend title 38, United States Code, to provide for the burial in Arlington National Cemetery of the cremated remains of certain persons whose service has been determined to be active service.",
            "latest_action": "Received in the Senate and Read twice and referred to the Committee on Veterans' Affairs."
          },
          "description": "To amend title 38, United States Code, to provide for the burial of the cremated remains of persons who served as Women",
          "question": "On Motion to Suspend the Rules and Pass, as Amended",
          "date": "2016-03-22",
          "time": "15:34:00",
          "position": "Yes"
        },
        ...
        {
          "member_id": "K000388",
          "chamber": "House",
          "congress": "114",
          "session": "2",
          "roll_call": "38",
          "bill": {
            "number": "H R 1644",
            "bill_uri": "https://api.propublica.org/congress/v1/114/bills/hr1644.json",
            "title": "Supporting Transparent Regulatory and Environmental Actions in Mining Act",
            "latest_action": "Received in the Senate and Read twice and referred to the Committee on Energy and Natural Resources."
          },
          "description": "Supporting Transparent Regulatory and Environmental Actions in Mining Act",
          "question": "On Agreeing to the Amendment",
          "date": "2016-01-12",
          "time": "16:28:00",
          "position": "No"
        }
      ]
    }
  ]
}

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/114/senate/sessions/2/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) 2016 Pro Publica Inc. All Rights Reserved.",
  "results": {
    "votes": {
      "vote": {
        "congress": "114",
        "session": "2",
        "chamber": "Senate",
        "roll_call": "17",
        "bill": {
          "api_uri": "https://api.propublica.org/congress/v1/114/bills/s2012.json",
          "title": "Energy Policy Modernization Act of 2015",
          "latest_action": "Motion by Senator McConnell to reconsider the vote by which cloture was not invoked on the measure (Roll Call Vote No. 17) entered in Senate."
        },
        "question": "On the Cloture Motion",
        "description": "An original bill to provide for the modernization of the energy policy of the United States, and for other purposes.",
        "vote_type": "3/5",
        "date": "2016-02-04",
        "time": "12:05:00",
        "result": "Cloture Motion Rejected",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "5",
          "no": "39",
          "present": "0",
          "not_voting": "0",
          "majority_position": "No"
        },
        "republican": {
          "yes": "37",
          "no": "15",
          "present": "0",
          "not_voting": "2",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "43",
          "no": "54",
          "present": "0",
          "not_voting": "3"
        },
        "positions": [
          {
            "member_id": "A000360",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "A000368",
            "vote_position": "No",
            "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": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "B000711",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "B000944",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "B001135",
            "vote_position": "No",
            "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": "C000542",
            "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": "C001095",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "C000880",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "C001098",
            "vote_position": "Not Voting",
            "dw_nominate": ""
          },
          {
            "member_id": "D000618",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "D000607",
            "vote_position": "Yes",
            "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": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "F000463",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "F000444",
            "vote_position": "No",
            "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": "H000338",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "H001046",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "H001069",
            "vote_position": "Yes",
            "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": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "K000383",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "K000360",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "K000367",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "L000575",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "L000174",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "L000577",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "M001183",
            "vote_position": "Yes",
            "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": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "M000639",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "M001176",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "M000702",
            "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": "No",
            "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": "R000146",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "R000584",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "R000307",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "R000605",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "R000595",
            "vote_position": "Not Voting",
            "dw_nominate": ""
          },
          {
            "member_id": "S000033",
            "vote_position": "Not Voting",
            "dw_nominate": ""
          },
          {
            "member_id": "S001197",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "S001194",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "S000148",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "S001184",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "S001141",
            "vote_position": "Yes",
            "dw_nominate": ""
          },
          {
            "member_id": "S001181",
            "vote_position": "Yes",
            "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": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "U000039",
            "vote_position": "No",
            "dw_nominate": ""
          },
          {
            "member_id": "V000127",
            "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": ""
          }
        ]
      },
      "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/2016/01.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": {
    "chamber": "Senate",
    "year": "2016",
    "month": "Jan.",
    "num_results": "9",
    "votes": [
      {
        "congress": "114",
        "session": "2",
        "roll_call": "9",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/9.json",
        "bill_number": "S. 2012",
        "question": "On the Amendment",
        "description": "To modify the funding provided for the Advanced Research Projects Agency-Energy.",
        "vote_type": "1/2",
        "date": "2016-01-28",
        "time": "13:46:00",
        "result": "Amendment Agreed to",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "42",
          "no": "0",
          "present": "0",
          "not_voting": "2",
          "majority_position": "Yes"
        },
        "republican": {
          "yes": "12",
          "no": "37",
          "present": "0",
          "not_voting": "5",
          "majority_position": "No"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "55",
          "no": "37",
          "present": "0",
          "not_voting": "8"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "8",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/8.json",
        "bill_number": "S. 2012",
        "question": "On the Amendment",
        "description": "To require the Comptroller General of the United States to conduct a review and submit a report on energy production in the United States and the effects of crude oil exports.",
        "vote_type": "1/2",
        "date": "2016-01-28",
        "time": "12:28:00",
        "result": "Amendment Agreed to",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "41",
          "no": "0",
          "present": "0",
          "not_voting": "3",
          "majority_position": "Yes"
        },
        "republican": {
          "yes": "20",
          "no": "29",
          "present": "0",
          "not_voting": "5",
          "majority_position": "No"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "62",
          "no": "29",
          "present": "0",
          "not_voting": "9"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "7",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/7.json",
        "bill_number": "S. 2012",
        "question": "On the Amendment",
        "description": "To enable civilian research and development of advanced nuclear energy technologies by private and public institutions, to expand theoretical and practical knowledge of nuclear physics, chemistry, and materials science.",
        "vote_type": "1/2",
        "date": "2016-01-28",
        "time": "23:59:00",
        "result": "Amendment Agreed to",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "37",
          "no": "3",
          "present": "0",
          "not_voting": "4",
          "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": "87",
          "no": "4",
          "present": "0",
          "not_voting": "9"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "6",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/6.json",
        "bill_number": "PN326",
        "question": "On the Nomination",
        "description": "John Michael Vazquez, of New Jersey, to be United States District Judge for the District of New Jersey",
        "vote_type": "1/2",
        "date": "2016-01-27",
        "time": "17:30:00",
        "result": "Nomination Confirmed",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "39",
          "no": "0",
          "present": "0",
          "not_voting": "5",
          "majority_position": "Yes"
        },
        "republican": {
          "yes": "44",
          "no": "2",
          "present": "0",
          "not_voting": "8",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "84",
          "no": "2",
          "present": "0",
          "not_voting": "14"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "5",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/5.json",
        "bill_number": "S.J.Res.22",
        "question": "On the Cloture Motion",
        "description": "A joint resolution providing for congressional disapproval under chapter 8 of title 5, United States Code, of the rule submitted by the Corps of Engineers and the Environmental Protection Agency relating to the definition of 'waters of the United States' under the Federal Water Pollution Control Act.",
        "vote_type": "3/5",
        "date": "2016-01-21",
        "time": "10:29:00",
        "result": "Cloture Motion Rejected",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "3",
          "no": "38",
          "present": "0",
          "not_voting": "3",
          "majority_position": "No"
        },
        "republican": {
          "yes": "49",
          "no": "1",
          "present": "0",
          "not_voting": "4",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "0",
          "no": "1",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "52",
          "no": "40",
          "present": "0",
          "not_voting": "8"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "4",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/4.json",
        "bill_number": "H.R.4038",
        "question": "On the Cloture Motion",
        "description": "A bill to require that supplemental certifications and background investigations be completed prior to the admission of certain aliens as refugees, and for other purposes.",
        "vote_type": "3/5",
        "date": "2016-01-20",
        "time": "14:54:00",
        "result": "Cloture Motion Rejected",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "2",
          "no": "42",
          "present": "0",
          "not_voting": "0",
          "majority_position": "No"
        },
        "republican": {
          "yes": "53",
          "no": "0",
          "present": "0",
          "not_voting": "1",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "0",
          "no": "1",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "55",
          "no": "43",
          "present": "0",
          "not_voting": "2"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "3",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/3.json",
        "bill_number": "PN367",
        "question": "On the Nomination",
        "description": "Wilhelmina Marie Wright, of Minnesota, to be United States District Judge for the District of Minnesota",
        "vote_type": "1/2",
        "date": "2016-01-19",
        "time": "17:29:00",
        "result": "Nomination Confirmed",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "44",
          "no": "0",
          "present": "0",
          "not_voting": "0",
          "majority_position": "Yes"
        },
        "republican": {
          "yes": "13",
          "no": "36",
          "present": "0",
          "not_voting": "5",
          "majority_position": "No"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "58",
          "no": "36",
          "present": "0",
          "not_voting": "6"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "2",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/2.json",
        "bill_number": "S.2232",
        "question": "On Cloture on the Motion to Proceed",
        "description": "A bill to require a full audit of the Board of Governors of the Federal Reserve System and the Federal reserve banks by the Comptroller General of the United States, and for other purposes.",
        "vote_type": "3/5",
        "date": "2016-01-12",
        "time": "14:31:00",
        "result": "Cloture on the Motion to Proceed Rejected",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "1",
          "no": "42",
          "present": "0",
          "not_voting": "1",
          "majority_position": "No"
        },
        "republican": {
          "yes": "51",
          "no": "1",
          "present": "0",
          "not_voting": "2",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "1",
          "no": "1",
          "present": "0",
          "not_voting": "0"
        },
        "total": {
          "yes": "53",
          "no": "44",
          "present": "0",
          "not_voting": "3"
        }
      },
      {
        "congress": "114",
        "session": "2",
        "roll_call": "1",
        "vote_uri": "https://api.propublica.org/congress/v1/114/senate/sessions/2/votes/1.json",
        "bill_number": "PN11",
        "question": "On the Nomination",
        "description": "Luis Felipe Restrepo, of Pennsylvania, to be United States Circuit Judge for the Third Circuit",
        "vote_type": "1/2",
        "date": "2016-01-11",
        "time": "17:32:00",
        "result": "Nomination Confirmed",
        "tie_breaker": "",
        "tie_breaker_vote": "",
        "democratic": {
          "yes": "42",
          "no": "0",
          "present": "0",
          "not_voting": "2",
          "majority_position": "Yes"
        },
        "republican": {
          "yes": "39",
          "no": "6",
          "present": "0",
          "not_voting": "9",
          "majority_position": "Yes"
        },
        "independent": {
          "yes": "1",
          "no": "0",
          "present": "0",
          "not_voting": "1"
        },
        "total": {
          "yes": "82",
          "no": "6",
          "present": "0",
          "not_voting": "12"
        }
      }
    ]
  }
}

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/114/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 ProPublica Inc. All Rights Reserved.",
   "results":[
      {
         "congress": "115",
         "bill": "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_uri": "https://api.propublica.org/congress/v1/members/I000056.json",
         "gpo_pdf_uri": "https://www.gpo.gov/fdsys/pkg/BILLS-115hr21rfs/pdf/BILLS-115hr21rfs.pdf",
         "introduced_date": "2017-01-03",
         "cosponsors": "14",
         "primary_subject": "Government Operations and Politics",
         "committees": "House 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.",
         "house_passage_vote": "2017-01-04",
         "senate_passage_vote": null,
         "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/114/nominees/confirmed.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.",
  "congress": 114,
  "results": [
    {
      "id": "PN675",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN675.json",
      "date_received": "2015-07-21",
      "description": "Leonard Terry Strand, of South Dakota, to be United States District Judge for the Northern District of Iowa, vice Mark W. Bennett, retired.",
      "nominee_state": "IA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSJU.json",
      "latest_action_date": "2016-02-11",
      "status": "Confirmed"
    },
    {
      "id": "PN1040",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN1040.json",
      "date_received": "2015-12-18",
      "description": "Michael O. Johanns, of Nebraska, to be a Member of the Board of Directors of the Millennium Challenge Corporation for a term of three years, vice Lorne W. Craner, term expired.",
      "nominee_state": "NE",
      "committee_uri": null,
      "latest_action_date": "2016-02-11",
      "status": "Confirmed"
    },
    {
      "id": "PN1039",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN1039.json",
      "date_received": "2015-12-18",
      "description": "Morton H. Halperin, of the District of Columbia, to be a Member of the Board of Directors of the Millennium Challenge Corporation for a term of two years.  (Reappointment)",
      "nominee_state": "DC",
      "committee_uri": null,
      "latest_action_date": "2016-02-11",
      "status": "Confirmed"
    },
    {
      "id": "PN915",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN915.json",
      "date_received": "2015-10-21",
      "description": "Scot Alan Marciel, of California, a Career Member of the Senior Foreign Service, Class of Career Minister, to be Ambassador Extraordinary and Plenipotentiary of the United States of America to the Union of Burma.",
      "nominee_state": "CA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSFR.json",
      "latest_action_date": "2016-02-09",
      "status": "Confirmed"
    },
    {
      "id": "PN831",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN831.json",
      "date_received": "2015-09-15",
      "description": "Rebecca Goodgame Ebinger, of Iowa, to be United States District Judge for the Southern District of Iowa, vice James E. Gritzner, retired.",
      "nominee_state": "IA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSJU.json",
      "latest_action_date": "2016-02-08",
      "status": "Confirmed"
    },
    {
      "id": "PN870",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN870.json",
      "date_received": "2015-09-21",
      "description": "Ricardo A. Aguilera, of Virginia, to be an Assistant Secretary of the Air Force, vice Lisa S. Disbrow.",
      "nominee_state": "VA",
      "committee_uri": null,
      "latest_action_date": "2016-02-01",
      "status": "Confirmed"
    },
    {
      "id": "PN326",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN326.json",
      "date_received": "2015-03-26",
      "description": "John Michael Vazquez, of New Jersey, to be United States District Judge for the District of New Jersey, vice Joal A. Pisano, retired.",
      "nominee_state": "NJ",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSJU.json",
      "latest_action_date": "2016-01-27",
      "status": "Confirmed"
    },
    {
      "id": "PN874",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN874.json",
      "date_received": "2015-09-21",
      "description": "Lisa S. Disbrow, of Virginia, to be Under Secretary of the Air Force, vice Eric K. Fanning, resigned.",
      "nominee_state": "VA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSAS.json",
      "latest_action_date": "2016-01-20",
      "status": "Confirmed"
    },
    {
      "id": "PN367",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN367.json",
      "date_received": "2015-04-15",
      "description": "Wilhelmina Marie Wright, of Minnesota, to be United States District Judge for the District of Minnesota, vice Michael J. Davis, retiring.",
      "nominee_state": "MN",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSJU.json",
      "latest_action_date": "2016-01-19",
      "status": "Confirmed"
    },
    {
      "id": "PN11",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN11.json",
      "date_received": "2015-01-07",
      "description": "Luis Felipe Restrepo, of Pennsylvania, to be United States Circuit Judge for the Third Circuit, vice Anthony J. Scirica, retired.",
      "nominee_state": "PA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSJU.json",
      "latest_action_date": "2016-01-11",
      "status": "Confirmed"
    },
    {
      "id": "PN50",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN50.json",
      "date_received": "2015-01-08",
      "description": "Carlos J. Torres, of Virginia, to be Deputy Director of the Peace Corps, vice Carolyn Hessler Radelet, resigned.",
      "nominee_state": "VA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSFR.json",
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN226",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN226.json",
      "date_received": "2015-02-26",
      "description": "Suzette M. Kimball, of West Virginia, to be Director of the United States Geological Survey, vice Marcia K. McNutt, resigned.",
      "nominee_state": "VA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSEG.json",
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN337",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN337.json",
      "date_received": "2015-04-13",
      "description": "David Malcolm Robinson, of Connecticut, a Career Member of the Senior Foreign Service, Class of Minister-Counselor, to be an Assistant Secretary of State (Conflict and Stabilization Operations), vice Frederick D. Barton, resigned.",
      "nominee_state": "CT",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSFR.json",
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN336",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN336.json",
      "date_received": "2015-04-13",
      "description": "David Malcolm Robinson, of Connecticut, a Career Member of the Senior Foreign Service, Class of Minister-Counselor, to be Coordinator for Reconstruction and Stabilization, vice Frederick D. Barton, resigned.",
      "nominee_state": "CT",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSFR.json",
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN760",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN760.json",
      "date_received": "2015-08-05",
      "description": "Patrick Joseph Murphy, of Pennsylvania, to be Under Secretary of the Army, vice Brad R. Carson.",
      "nominee_state": "PA",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSAS.json",
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN871",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN871.json",
      "date_received": "2015-09-21",
      "description": "Shoshana Miriam Lew, of the District of Columbia, to be Chief Financial Officer, Department of Transportation, vice Sylvia I. Garcia, resigned.",
      "nominee_state": "DC",
      "committee_uri": null,
      "latest_action_date": "2015-12-18",
      "status": "Confirmed"
    },
    {
      "id": "PN424",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN424.json",
      "date_received": "2015-04-30",
      "description": "Robert A. Salerno, of the District of Columbia, to be an Associate Judge of the Superior Court of the District of Columbia for the term of fifteen years, vice Robert Isaac Richter, retired.",
      "nominee_state": "DC",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSGA.json",
      "latest_action_date": "2015-12-17",
      "status": "Confirmed"
    },
    {
      "id": "PN645",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN645.json",
      "date_received": "2015-07-09",
      "description": "Darlene Michele Soltys, of the District of Columbia, to be an Associate Judge of the Superior Court of the District of Columbia for the term of fifteen years, vice Natalia Combs Greene, retired.",
      "nominee_state": "DC",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSGA.json",
      "latest_action_date": "2015-12-17",
      "status": "Confirmed"
    },
    {
      "id": "PN331",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN331.json",
      "date_received": "2015-04-13",
      "description": "Gabriel Camarillo, of Texas, to be an Assistant Secretary of the Air Force, vice Daniel Ginsberg.",
      "nominee_state": "TX",
      "committee_uri": "https://api.propublica.org/congress/v1/114/senate/committees/SSAS.json",
      "latest_action_date": "2015-12-16",
      "status": "Confirmed"
    },
    {
      "id": "PN366",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN366.json",
      "date_received": "2015-04-15",
      "description": "Thomas Edgar Rothman, of Maryland, to be a Member of the National Council on the Arts for a term expiring September 3, 2016.  (New Position)",
      "nominee_state": "MD",
      "committee_uri": null,
      "latest_action_date": "2015-12-16",
      "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 ProPublica 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."
        }],
        "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/114/nominees/state/IL.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.",
  "congress": 114,
  "num_results": 15,
  "state": "IL",
  "results": [
    {
      "id": "PN946",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN946.json",
      "date_received": "2015-11-19",
      "description": "Phillip H. Cullom, of Illinois, to be an Assistant Secretary of Defense, vice Sharon E. Burke, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Armed Services",
      "latest_action_date": "2016-01-11",
      "status": "Withdrawn"
    },
    {
      "id": "PN1048",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN1048.json",
      "date_received": "2016-01-11",
      "description": "Thomas McLeary, of Illinois, to be a Member of the Board of Directors of the National Association of Registered Agents and Brokers for a term of two years.  (New Position)",
      "nominee_state": "IL",
      "committee": null,
      "latest_action_date": "2016-01-11",
      "status": "Pending"
    },
    {
      "id": "PN321",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN321.json",
      "date_received": "2015-03-26",
      "description": "Franklin R. Parker, of Illinois, to be an Assistant Secretary of the Navy, vice Juan M. Garcia III.",
      "nominee_state": "IL",
      "committee": "Committee on Armed Services",
      "latest_action_date": "2015-12-14",
      "status": "Confirmed"
    },
    {
      "id": "PN1009",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN1009.json",
      "date_received": "2015-12-14",
      "description": "Andrew Mayock, of Illinois, to be Deputy Director for Management, Office of Management and Budget, vice Beth F. Cobert.",
      "nominee_state": "IL",
      "committee": "Committee on Homeland Security and Governmental Affairs",
      "latest_action_date": "2015-12-14",
      "status": "Pending"
    },
    {
      "id": "PN758",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN758.json",
      "date_received": "2015-07-30",
      "description": "Darryl L. DePriest, of Illinois, to be Chief Counsel for Advocacy, Small Business Administration, vice Winslow Lorenzo Sargeant, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Small Business and Entrepreneurship",
      "latest_action_date": "2015-12-10",
      "status": "Confirmed"
    },
    {
      "id": "PN713",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN713.json",
      "date_received": "2015-07-27",
      "description": "Victoria Marie Baecher Wassmer, of Illinois, to be Under Secretary of Energy, vice Kristina M. Johnson, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Energy and Natural Resources",
      "latest_action_date": "2015-11-19",
      "status": "Pending"
    },
    {
      "id": "PN776",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN776.json",
      "date_received": "2015-09-08",
      "description": "Edward L. Gilmore, of Illinois, to be United States Marshal for the Northern District of Illinois for the term of four years, vice Darryl Keith McPherson, term expired.",
      "nominee_state": "IL",
      "committee": "Committee on the Judiciary",
      "latest_action_date": "2015-10-29",
      "status": "Confirmed"
    },
    {
      "id": "PN65",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN65.json",
      "date_received": "2015-01-13",
      "description": "Jay Neal Lerner, of Illinois, to be Inspector General, Federal Deposit Insurance Corporation, vice Jon T. Rymer, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Banking, Housing, and Urban Affairs",
      "latest_action_date": "2015-09-29",
      "status": "Pending"
    },
    {
      "id": "PN840",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN840.json",
      "date_received": "2015-09-16",
      "description": "Steven H. Cohen, of Illinois, to be a Member of the Board of Trustees of the Harry S Truman Scholarship Foundation for a term expiring December 10, 2019.  (Reappointment)",
      "nominee_state": "IL",
      "committee": null,
      "latest_action_date": "2015-09-16",
      "status": "Pending"
    },
    {
      "id": "PN325",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN325.json",
      "date_received": "2015-03-26",
      "description": "Alaina B. Teplitz, of Illinois, a Career Member of the Senior Foreign Service, Class of Minister-Counselor, to be Ambassador Extraordinary and Plenipotentiary of the United States of America to the Federal Democratic Republic of Nepal.",
      "nominee_state": "IL",
      "committee": "Committee on Foreign Relations",
      "latest_action_date": "2015-08-05",
      "status": "Confirmed"
    },
    {
      "id": "PN207",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN207.json",
      "date_received": "2015-02-25",
      "description": "Monica C. Regalbuto, of Illinois, to be an Assistant Secretary of Energy (Environmental Management), vice Ines R. Triay, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Armed Services",
      "latest_action_date": "2015-07-09",
      "status": "Pending"
    },
    {
      "id": "PN468",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN468.json",
      "date_received": "2015-05-11",
      "description": "Julius Lloyd Horwich, of Illinois, to be Assistant Secretary for Legislation and Congressional Affairs, Department of Education, vice Gabriella Cecilia Gomez.",
      "nominee_state": "IL",
      "committee": null,
      "latest_action_date": "2015-06-25",
      "status": "Pending"
    },
    {
      "id": "PN192",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN192.json",
      "date_received": "2015-02-12",
      "description": "Mary Catherine Phee, of Illinois, a Career Member of the Senior Foreign Service, Class of Minister-Counselor, to be Ambassador Extraordinary and Plenipotentiary of the United States of America to the Republic of South Sudan.",
      "nominee_state": "IL",
      "committee": "Committee on Foreign Relations",
      "latest_action_date": "2015-06-24",
      "status": "Confirmed"
    },
    {
      "id": "PN210",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN210.json",
      "date_received": "2015-02-25",
      "description": "Anne Elizabeth Wall, of Illinois, to be a Deputy Under Secretary of the Treasury, vice Alastair M. Fitzpayne, resigned.",
      "nominee_state": "IL",
      "committee": "Committee on Finance",
      "latest_action_date": "2015-06-24",
      "status": "Confirmed"
    },
    {
      "id": "PN289",
      "uri": "https://api.propublica.org/congress/v1/114/nominees/PN289.json",
      "date_received": "2015-03-16",
      "description": "Ian C. Kelly, of Illinois, a Career Member of the Senior Foreign Service, Class of Minister-Counselor, to be Ambassador Extraordinary and Plenipotentiary of the United States of America to Georgia.",
      "nominee_state": "IL",
      "committee": "Committee on Foreign Relations",
      "latest_action_date": "2015-06-24",
      "status": "Confirmed"
    }
  ]
}

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/113/house/committees.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": "113",
      "chamber": "House",
      "num_results": "22",
      "offset": "0",
      "committees": [
        {
          "id": "HSHA",
          "name": "Committee on Administration",
          "url": "http://cha.house.gov/",
          "democratic_rss": "http://democrats.cha.house.gov/rss.xml",
          "republican_rss": "http://cha.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSHA.json",
          "chair": "Candice S. Miller",
          "chair_id": "M001150",
          "chair_party": "R",
          "chair_state": "MI",
          "chair_uri": "https://api.propublica.org/congress/v1/members/M001150.json",
          "ranking_member_id": "B001227"
        },
        {
          "id": "HSAG",
          "name": "Committee on Agriculture",
          "url": "http://agriculture.house.gov/",
          "democratic_rss": "http://democrats.agriculture.house.gov/Rss.aspx?GroupID=1",
          "republican_rss": "http://agriculture.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSAG.json",
          "chair": "Frank D. Lucas",
          "chair_id": "L000491",
          "chair_party": "R",
          "chair_state": "OK",
          "chair_uri": "https://api.propublica.org/congress/v1/members/L000491.json",
          "ranking_member_id": "P000258"
        },
        {
          "id": "HSAP",
          "name": "Committee on Appropriations",
          "url": "http://appropriations.house.gov/",
          "democratic_rss": "http://democrats.appropriations.house.gov/index.php?option=com_bca-rss-syndicator&feed_id=1&Itemid=15",
          "republican_rss": "http://appropriations.house.gov/news/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSAP.json",
          "chair": "Harold Rogers",
          "chair_id": "R000395",
          "chair_party": "R",
          "chair_state": "KY",
          "chair_uri": "https://api.propublica.org/congress/v1/members/R000395.json",
          "ranking_member_id": "L000480"
        },
        {
          "id": "HSAS",
          "name": "Committee on Armed Services",
          "url": "http://armedservices.house.gov/",
          "democratic_rss": "http://democrats.armedservices.house.gov/index.cfm/rss/feed",
          "republican_rss": "http://armedservices.house.gov/index.cfm/rss/feed",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSAS.json",
          "chair": "Howard P. McKeon",
          "chair_id": "M000508",
          "chair_party": "R",
          "chair_state": "CA",
          "chair_uri": "https://api.propublica.org/congress/v1/members/M000508.json",
          "ranking_member_id": "S000510"
        },
        {
          "id": "HSED",
          "name": "Committee on Education and the Workforce",
          "url": "http://edlabor.house.gov/",
          "democratic_rss": "http://democrats.edworkforce.house.gov/rss.xml",
          "republican_rss": "http://edworkforce.house.gov/news/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSED.json",
          "chair": "John Kline",
          "chair_id": "K000363",
          "chair_party": "R",
          "chair_state": "MN",
          "chair_uri": "https://api.propublica.org/congress/v1/members/K000363.json",
          "ranking_member_id": "M000725"
        },
        {
          "id": "HSIF",
          "name": "Committee on Energy and Commerce",
          "url": "http://energycommerce.house.gov/",
          "democratic_rss": "",
          "republican_rss": "http://energycommerce.house.gov/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSIF.json",
          "chair": "Fred Upton",
          "chair_id": "U000031",
          "chair_party": "R",
          "chair_state": "MI",
          "chair_uri": "https://api.propublica.org/congress/v1/members/U000031.json",
          "ranking_member_id": "W000215"
        },
        {
          "id": "HSBA",
          "name": "Committee on Financial Services",
          "url": "http://financialservices.house.gov/",
          "democratic_rss": "http://democrats.financialservices.house.gov/Rss.aspx?GroupID=1",
          "republican_rss": "http://financialservices.house.gov/news/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/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"
        },
        {
          "id": "HSFA",
          "name": "Committee on Foreign Affairs",
          "url": "http://foreignaffairs.house.gov/",
          "democratic_rss": "http://democrats.foreignaffairs.house.gov/rss.asp",
          "republican_rss": "http://foreignaffairs.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSFA.json",
          "chair": "Ed 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"
        },
        {
          "id": "HSHM",
          "name": "Committee on Homeland Security",
          "url": "http://homeland.house.gov/",
          "democratic_rss": "",
          "republican_rss": "http://homeland.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/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"
        },
        {
          "id": "HSII",
          "name": "Committee on Natural Resources",
          "url": "http://resourcescommittee.house.gov/",
          "democratic_rss": "http://democrats.naturalresources.house.gov/rss.xml",
          "republican_rss": "http://naturalresources.house.gov/news.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSII.json",
          "chair": "Doc Hastings",
          "chair_id": "H000329",
          "chair_party": "R",
          "chair_state": "WA",
          "chair_uri": "https://api.propublica.org/congress/v1/members/H000329.json",
          "ranking_member_id": "M000133"
        },
        {
          "id": "HSGO",
          "name": "Committee on Oversight and Government Reform",
          "url": "http://oversight.house.gov/",
          "democratic_rss": "",
          "republican_rss": "http://oversight.house.gov/feed/rss/",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSGO.json",
          "chair": "Darrell Issa",
          "chair_id": "I000056",
          "chair_party": "R",
          "chair_state": "CA",
          "chair_uri": "https://api.propublica.org/congress/v1/members/I000056.json",
          "ranking_member_id": "C000984"
        },
        {
          "id": "HSRU",
          "name": "Committee on Rules",
          "url": "http://www.rules.house.gov/",
          "democratic_rss": "http://democrats.rules.house.gov/rss.xml",
          "republican_rss": "http://rules.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/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"
        },
        {
          "id": "HSSY",
          "name": "Committee on Science, Space, and Technology",
          "url": "http://science.house.gov/",
          "democratic_rss": "http://democrats.science.house.gov/rss.xml",
          "republican_rss": "http://science.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/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"
        },
        {
          "id": "HSSM",
          "name": "Committee on Small Business",
          "url": "http://www.house.gov/smbiz/",
          "democratic_rss": "http://democrats.smallbusiness.house.gov/rss.xml",
          "republican_rss": "http://smallbusiness.house.gov/news/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSSM.json",
          "chair": "Sam Graves",
          "chair_id": "G000546",
          "chair_party": "R",
          "chair_state": "MO",
          "chair_uri": "https://api.propublica.org/congress/v1/members/G000546.json",
          "ranking_member_id": "V000081"
        },
        {
          "id": "HSSO",
          "name": "Committee on Standards of Official Conduct",
          "url": "http://ethics.house.gov/",
          "democratic_rss": "",
          "republican_rss": "http://ethics.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSSO.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": "S001156"
        },
        {
          "id": "HSBU",
          "name": "Committee on the Budget",
          "url": "http://budget.house.gov/",
          "democratic_rss": "http://feeds.feedburner.com/BudgetCommittee",
          "republican_rss": "http://budget.house.gov/news/rss.aspx",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSBU.json",
          "chair": "Paul D. Ryan",
          "chair_id": "R000570",
          "chair_party": "R",
          "chair_state": "WI",
          "chair_uri": "https://api.propublica.org/congress/v1/members/R000570.json",
          "ranking_member_id": "V000128"
        },
        {
          "id": "HSJU",
          "name": "Committee on the Judiciary",
          "url": "http://judiciary.house.gov/",
          "democratic_rss": "http://democrats.judiciary.house.gov/rss.xml",
          "republican_rss": "",
          "api_uri": "https://api.propublica.org/congress/v1/113/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"
        },
        {
          "id": "HSPW",
          "name": "Committee on Transportation and Infrastructure",
          "url": "http://transportation.house.gov/",
          "democratic_rss": "http://democrats.transportation.house.gov/rss.xml",
          "republican_rss": "http://transportation.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/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": "R000011"
        },
        {
          "id": "HSVR",
          "name": "Committee on Veterans' Affairs",
          "url": "http://veterans.house.gov/",
          "democratic_rss": "http://democrats.veterans.house.gov/rss.xml",
          "republican_rss": "http://veterans.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSVR.json",
          "chair": "Jeff Miller",
          "chair_id": "M001144",
          "chair_party": "R",
          "chair_state": "FL",
          "chair_uri": "https://api.propublica.org/congress/v1/members/M001144.json",
          "ranking_member_id": "M001149"
        },
        {
          "id": "HSWM",
          "name": "Committee on Ways and Means",
          "url": "http://waysandmeans.house.gov/",
          "democratic_rss": "http://democrats.waysandmeans.house.gov/rss.xml",
          "republican_rss": "",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSWM.json",
          "chair": "Dave Camp",
          "chair_id": "C000071",
          "chair_party": "R",
          "chair_state": "MI",
          "chair_uri": "https://api.propublica.org/congress/v1/members/C000071.json",
          "ranking_member_id": "L000263"
        },
        {
          "id": "HSIG",
          "name": "Permanent Select Committee on Intelligence",
          "url": "http://intelligence.house.gov/",
          "democratic_rss": "http://democrats.intelligence.house.gov/rss.xml",
          "republican_rss": "http://intelligence.house.gov/rss.xml",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSIG.json",
          "chair": "Mike Rogers",
          "chair_id": "R000572",
          "chair_party": "R",
          "chair_state": "MI",
          "chair_uri": "https://api.propublica.org/congress/v1/members/R000572.json",
          "ranking_member_id": "R000576"
        },
        {
          "id": "HSBG",
          "name": "Select Committee on Benghazi",
          "url": "http://benghazi.house.gov/",
          "democratic_rss": "",
          "republican_rss": "",
          "api_uri": "https://api.propublica.org/congress/v1/113/house/committees/HSBG.json",
          "chair": "Trey Gowdy",
          "chair_id": "G000566",
          "chair_party": "R",
          "chair_state": "SC",
          "chair_uri": "https://api.propublica.org/congress/v1/members/G000566.json",
          "ranking_member_id": "C000984"
        }
      ]
    }
  ]
}

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.