GovTrack API Documentation

GovTrack’s API provides programmatic access to information about the U.S. Congress.

Our API provides live access to most of the information found on GovTrack. Data for the 113th Congress are from github:unitedstates/congress-legislators and github:unitedstates/congress, community projects that we helped create and now help maintain. Historical data is from our legacy scrapers.

Consider using our bulk raw data, or the bulk offerings of the two github projects, for bulk access to the complete database, rather than making many individual queries, if you need the whole thing.

Getting Started

Consider joining our mail list for notices about any data format changes. If you have any ideas for making GovTrack data better, please post a message to let others know. We’d appreciate it if you let us know how you are using the data, just to satisfy our curiosity. Email us at the address at the bottom of the page.

You must agree to the license terms before accessing the bulk data or API. The terms are about as unrestrictive as terms go. Note that we do not make a distinction between commercial and noncommercial use. If you are looking for an SLA, you’ll need to contact us at the address at the bottom of the page.

Examples

Here are some quick examples:

Libraries/Wrappers

You might find these useful: node.js wrapper, GovTrack on Temboo.

General Options

Output Format

Results are returned in JSON by default, but you can change the result format to JSONP, XML, or CSV using the format query string parameter. For instance, add format=jsonp&callback=your_function, format=xml, or format=csv to your query string arguments. (You will need either a ? or an & to separate it from the rest of the URL or arguments, of course.)

You can also specify which fields you want using the fields argument. Use double-underscores to span relationships.

Limit/Offset

Results are paged 100 per call by default. This is true even in CSV format. Set the limit parameter to a high value to get all of the results at once. Use offset to page through results. The maximum limit is 6000.

Sort

You can sort results on a field using the sort parameter on any sortable field (as listed below). Prepend the field name with a minus sign to sort in descending order. To sort on multiple fields, separate fields with the pipe (|) character.

Filtering

You can filter output on any filterable field (which are indicated in the field documentation below) using query string parameters (e.g. filter1=value1&filter2=value2. Endpoints backed by Django Haystack also support the q field which performs a full-text search. To specify a null value, just use “null”. For boolean fields, use “true” and “false” (lowercase). For date and date-time fields, use ISO format (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS), like you’ll see in the output.

Besides exact comparisons, you can also use several operators as fieldname__operator. The operators are contains, exact, gt, gte, lt, lte, in, startswith, and range. The in and range operators accept multiple values separated by pipe (|) characters.

Other Notes

CORS is enabled for API URLs without credentials passing.

Examples

To list bills in the 112th Congress use a filter like congress=112 like so:
https://www.govtrack.us/api/v2/bill?congress=112

The bills and people APIs also support the q field which performs a full-text search:
https://www.govtrack.us/api/v2/bill?q=internet

To find votes this year, filter using a date:
https://www.govtrack.us/api/v2/vote?created__gt=2012-01-01T00:00:00

Here is an example of using the format field to get output in CSV format, requesting 600 results with limit, filtering (current=true), and requesting particular fields in the output (with underscore notation to span relationships). To get a list of currently serving Members of Congress in CSV format use:
https://www.govtrack.us/api/v2/role?current=true&format=csv&fields=state,district,title_long,person__firstname,person__lastname,person__name&limit=600.

Here is an example of sorting a date field reverse-chronologically. To find the most recent votes:
https://www.govtrack.us/api/v2/vote?sort=-created

The in and range operators accept multiple values separated by pipe characters. To find bills whose status is/was either signed by the president or enacted by veto override use:
https://www.govtrack.us/api/v2/bill?current_status__in=enacted_signed|enacted_veto_override|enacted_tendayrule

Access Points and Schemas

The following resources are available in the API.

Bill

A bill represents a bill or resolution introduced in the United States Congress.

Use the list API at https://www.govtrack.us/api/v2/bill to get a list of objects of this type. Add a slash and the ID of any object to get just that object. For instance, try out https://www.govtrack.us/api/v2/bill/76416.

{
    "bill_resolution_type": "resolution", 
    "bill_type": "house_resolution", 
    "bill_type_label": "H.Res.", 
    "committees": [], 
    "congress": 112, 
    "cosponsors": [], 
    "current_status": "passed_simpleres", 
    "current_status_date": "2011-01-05", 
    "current_status_description": "This simple resolution was agreed to on January 5, 2011. That is the end of the legislative process for a simple resolution.", 
    "current_status_label": "Agreed To (Simple Resolution)", 
    "display_number": "H.Res. 1", 
    "docs_house_gov_postdate": null, 
    "id": 76416, 
    "introduced_date": "2011-01-05", 
    "is_alive": false, 
    "is_current": false, 
    "link": "https://www.govtrack.us/congress/bills/112/hres1", 
    "lock_title": false, 
    "major_actions": [
        [
            "datetime.datetime(2011, 1, 5, 14, 29)", 
            6, 
            "On agreeing to the resolution Agreed to by voice vote.", 
            "<vote how=\"by voice vote\" type=\"vote\" datetime=\"2011-01-05T14:29:00-05:00\" where=\"h\" result=\"pass\" state=\"PASSED:SIMPLERES\">\n      <text>On agreeing to the resolution Agreed to by voice vote.</text>\n      <reference ref=\"CR H6\" label=\"text\"/>\n    </vote>\n    "
        ]
    ], 
    "noun": "resolution", 
    "number": 1, 
    "related_bills": [], 
    "senate_floor_schedule_postdate": null, 
    "sliplawnum": null, 
    "sliplawpubpriv": null, 
    "source": "thomas-congproj", 
    "source_link": null, 
    "sponsor": {
        "bioguideid": "H001036", 
        "birthday": "1957-05-29", 
        "cspanid": 1003619, 
        "firstname": "Jeb", 
        "gender": "male", 
        "gender_label": "Male", 
        "id": 400175, 
        "lastname": "Hensarling", 
        "link": "https://www.govtrack.us/congress/members/jeb_hensarling/400175", 
        "middlename": "", 
        "name": "Rep. Jeb Hensarling [R-TX5]", 
        "namemod": "", 
        "nickname": "", 
        "osid": "N00024922", 
        "pvsid": "49827", 
        "sortname": "Hensarling, Jeb (Rep.) [R-TX5]", 
        "twitterid": "RepHensarling", 
        "youtubeid": "repjebhensarling"
    }, 
    "sponsor_role": {
        "caucus": null, 
        "congress_numbers": [
            112
        ], 
        "current": false, 
        "description": "Representative for Texas's 5th congressional district", 
        "district": 5, 
        "enddate": "2013-01-03", 
        "extra": {
            "address": "129 Cannon HOB; Washington DC 20515-4305", 
            "contact_form": "http://www.house.gov/hensarling/contact_web.shtml", 
            "fax": "202-226-4888", 
            "office": "129 Cannon House Office Building"
        }, 
        "id": 1421, 
        "leadership_title": null, 
        "party": "Republican", 
        "person": 400175, 
        "phone": "202-225-3484", 
        "role_type": "representative", 
        "role_type_label": "Representative", 
        "senator_class": null, 
        "senator_rank": null, 
        "startdate": "2011-01-05", 
        "state": "TX", 
        "title": "Rep.", 
        "title_long": "Representative", 
        "website": "http://www.house.gov/hensarling"
    }, 
    "terms": [
        {
            "id": 5938, 
            "name": "Congress", 
            "term_type": "new", 
            "term_type_label": "New"
        }, 
        {
            "id": 5944, 
            "name": "Congressional officers and employees", 
            "term_type": "new", 
            "term_type_label": "New"
        }, 
        {
            "id": 5947, 
            "name": "House of Representatives", 
            "term_type": "new", 
            "term_type_label": "New"
        }
    ], 
    "title": "H.Res. 1 (112th): Electing officers of the House of Representatives.", 
    "title_without_number": "Electing officers of the House of Representatives.", 
    "titles": [
        [
            "official", 
            "introduced", 
            "Electing officers of the House of Representatives."
        ]
    ]
}

Fields

q
Filters according to a full-text search on the object.
Filterable (without operators).
bill_resolution_type
The appropriate noun to use to refer to this instance, either 'bill' or 'resolution'.
bill_type
The bill's type (e.g. H.R., S., H.J.Res. etc.)
Filterable with operators. Sortable.
This field can take on the following values:
Value Notes
house_resolution H.Res.
House simple resolutions, which do not have the force of law
senate_bill S.
Senate bills
senate_joint_resolution S.J.Res.
Joint resolutions originating in the Senate, which may be used to enact laws or propose constitutional amendments
house_bill H.R.
House bills
house_concurrent_resolution H.Con.Res.
Concurrent resolutions originating in the House, which do not have the force of law
senate_concurrent_resolution S.Con.Res.
Concurrent resolutions originating in the Senate, which do not have the force of law
house_joint_resolution H.J.Res.
Joint resolutions originating in the House, which may be used to enact laws or propose constitutional amendments
senate_resolution S.Res.
Senate simple resolutions, which do not have the force of law
committees
Committees to which the bill has been referred. Returned as a list of JSON dicts (or equivalent in other output formats). Only returned in a query for a single object.
Filterable with operators. Sortable. When filtering, specify the ID of one target object to test if the target is among the values of this field.
congress
The number of the Congress in which the bill was introduced. The current Congress is 114.
Filterable with operators. Sortable.
cosponsors
The bill's cosponsors. Returned as a list of JSON dicts (or equivalent in other output formats). Only returned in a query for a single object.
Filterable with operators. Sortable. When filtering, specify the ID of one target object to test if the target is among the values of this field.
current_status
The current status of the bill.
Filterable with operators. Sortable.
This field can take on the following values:
Value Notes
prov_kill_veto Vetoed (No Override Attempt)
Vetoed by the President but the veto can be overridden.
fail_second_senate Passed House, Failed Senate
Passed the House but failed in the Senate.
passed_bill Passed House & Senate
The bill passed both chambers of Congress in identical form and goes on to the President for signing next.
passed_constamend Agreed To (Constitutional Amendment Proposal)
The resolution proposing a constitutional amendment was agreed to by both chambers of Congress and goes on to the states.
pass_back_senate Passed Senate with Changes
The Senate passed the bill with changes and sent it back to the House.
vetoed_override_fail_second_house Vetoed & Override Passed Senate, Failed in House
The Senate overrode the veto but the House's attempt to override the veto failed.
fail_originating_house Failed House
Failed in the House, its originating chamber
fail_second_house Passed Senate, Failed House
Passed the Senate but failed in the House.
override_pass_over_house Vetoed & House Overrides (Senate Next)
The House passed a veto override, sending it to the Senate.
override_pass_over_senate Vetoed & Senate Overrides (House Next)
The Senate passed a veto override, sending it to the House.
pass_back_house Passed House with Changes
The House passed the bill with changes and sent it back to the Senate.
prov_kill_cloturefailed Failed Cloture
Cloture (ending a filibuster) failed but can be tried again.
enacted_veto_override Enacted — Veto Overridden
Enacted by a veto override.
passed_concurrentres Agreed To (Concurrent Resolution)
The concurrent resolution was agreed to by both chambers of Congress. This is the final status for concurrent resolutions.
prov_kill_suspensionfailed Failed Under Suspension
Passage failed under "suspension of the rules" but can be voted on again.
passed_simpleres Agreed To (Simple Resolution)
The simple resolution was agreed to in the chamber in which it was introduced. This is a simple resolution's final status.
vetoed_pocket Pocket Vetoed
Pocket vetoed by the President.
vetoed_override_fail_originating_house Vetoed & Override Failed in House
The House's attempt to override a veto failed.
conference_passed_senate Conference Report Agreed to by Senate
The Senate approved a conference committee report to resolve differences. The House must also approve it.
fail_originating_senate Failed Senate
Failed in the Senate, its originating chamber
pass_over_senate Passed Senate
Passed the Senate, waiting for a House vote next.
prov_kill_pingpongfail Failed to Resolve Differences
The House or Senate failed to resolve differences with the other chamber but can try again.
enacted_signed Enacted — Signed by the President
Enacted by a signature of the President.
pass_over_house Passed House
Passed the House, waiting for a Senate vote next.
conference_passed_house Conference Report Agreed to by House
The House approved a conference committee report to resolve differences. The Senate must also approve it.
reported Reported by Committee
Reported by a committee in the originating chamber.
vetoed_override_fail_second_senate Vetoed & Override Passed House, Failed in Senate
The House overrode the veto but the Senate's attempt to override the veto failed.
vetoed_override_fail_originating_senate Vetoed & Override Failed in Senate
The Senate's attempt to override a veto failed.
enacted_tendayrule Enacted — By 10 Day Rule
Enacted by failing to be returned by the President within ten days (Sundays excepted).
introduced Introduced
Introduced but not yet referred to a committee.
enacted_unknown Enacted (Unknown Final Step)
Enacted. It is not known whether the President signed the bill due to limitations in the source data.
referred Referred to Committee
Referred to a committee in the originating chamber.
current_status_date
The date of the last major action on the bill corresponding to the current_status.
Filterable with operators. Sortable.
current_status_description
Descriptive text for the bill's current status.
display_number
The bill's number, suitable for display, e.g. H.R. 1234.
docs_house_gov_postdate
The date on which the bill was posted to http://docs.house.gov (which is different from the date it was expected to be debated).
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
introduced_date
The date the bill was introduced.
Filterable with operators. Sortable.
is_alive
Whether the bill was introduced in the current session of Congress and the bill's status is not a final status (i.e. can take no more action like a failed vote).
is_current
Whether the bill was introduced in the current session of Congress.
link
The canonical URL of this resource.
lock_title
Whether the title has been manually overridden.
major_actions
noun
The appropriate noun to use to refer to this instance, either 'bill' or 'resolution'.
number
The bill's number (just the integer part).
Filterable with operators. Sortable.
related_bills
senate_floor_schedule_postdate
The date on which the bill was posted on the Senate Floor Schedule (which is different from the date it was expected to be debated).
sliplawnum
For enacted laws, the slip law number (i.e. the law number in P.L. XXX-123). Unique with congress and sliplawpublpriv.
sliplawpubpriv
For enacted laws, whether the law is a public (PUB) or private (PRI) law. Unique with congress and sliplawnum.
source
The primary source for this bill's metadata.
source_link
When set, a link to the page on the primary source website for this bill. Set when source='americanmemory' only.
sponsor
The primary sponsor of the bill. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object. To search for a null value, filter on the special string 'null'.
sponsor_role
The role of the primary sponsor of the bill at the time the bill was introduced. The full object is included in the response as a JSON dict (or equivalent in other output formats).
terms
Subject areas associated with the bill. Returned as a list of JSON dicts (or equivalent in other output formats). Only returned in a query for a single object.
Filterable with operators. Sortable. When filtering, specify the ID of one target object to test if the target is among the values of this field.
title
The bill's primary display title, including its number.
title_without_number
The title of the bill without the number.
titles

Cosponsorship

A (bill, person) pair indicating cosponsorship, with join and withdrawn dates.

Use the list API at https://www.govtrack.us/api/v2/cosponsorship to get a list of objects of this type.

{
    "meta": {
        "limit": 5, 
        "offset": 0, 
        "total_count": 3056673
    }, 
    "objects": [
        {
            "bill": 344877, 
            "id": 3297877, 
            "joined": "2016-09-22", 
            "person": 412523, 
            "role": 43609, 
            "withdrawn": null
        }, 
        {
            "bill": 346661, 
            "id": 3297876, 
            "joined": "2016-09-22", 
            "person": 400432, 
            "role": 43154, 
            "withdrawn": null
        }, 
        {
            "bill": 344372, 
            "id": 3297875, 
            "joined": "2016-09-22", 
            "person": 400326, 
            "role": 43367, 
            "withdrawn": null
        }, 
        {
            "bill": 341845, 
            "id": 3297874, 
            "joined": "2016-09-22", 
            "person": 400194, 
            "role": 1587, 
            "withdrawn": null
        }, 
        {
            "bill": 346659, 
            "id": 3297873, 
            "joined": "2016-09-22", 
            "person": 412195, 
            "role": 43446, 
            "withdrawn": null
        }
    ]
}

Fields

bill
The bill being cosponsored. Returned as an integer ID.
Filterable.
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
joined
The date the cosponsor was added. It is always greater than or equal to the bill's introduced_date.
Filterable with operators. Sortable.
person
The cosponsoring person. Returned as an integer ID.
Filterable when also filtering on bill.
role
The role of the cosponsor at the time of cosponsorship. Returned as an integer ID.
Filterable with operators. Sortable.
withdrawn
If the cosponsor withdrew his/her support, the date of withdrawl. Otherwise empty.

Person

Members of Congress, Presidents, and Vice Presidents since the founding of the nation.

Use the list API at https://www.govtrack.us/api/v2/person to get a list of objects of this type. Add a slash and the ID of any object to get just that object. For instance, try out https://www.govtrack.us/api/v2/person/400326.

{
    "bioguideid": "P000523", 
    "birthday": "1940-08-17", 
    "committeeassignments": [
        {
            "committee": 2681, 
            "id": 208119, 
            "person": 400326, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": 2685, 
            "id": 208216, 
            "person": 400326, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": 2675, 
            "id": 208436, 
            "person": 400326, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": 2687, 
            "id": 208788, 
            "person": 400326, 
            "role": "ranking_member", 
            "role_label": "Ranking Member"
        }
    ], 
    "cspanid": 6748, 
    "firstname": "David", 
    "gender": "male", 
    "gender_label": "Male", 
    "id": 400326, 
    "lastname": "Price", 
    "link": "https://www.govtrack.us/congress/members/david_price/400326", 
    "middlename": "E.", 
    "name": "Rep. David Price [D-NC4]", 
    "namemod": "", 
    "nickname": "", 
    "osid": "N00002260", 
    "pvsid": "119", 
    "roles": [
        {
            "caucus": null, 
            "congress_numbers": [
                100
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "1989-01-03", 
            "extra": null, 
            "id": 2726, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1987-01-06", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                101
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "1991-01-03", 
            "extra": null, 
            "id": 2727, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1989-01-03", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                102
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "1993-01-03", 
            "extra": null, 
            "id": 2728, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1991-01-03", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                103
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "1995-01-03", 
            "extra": null, 
            "id": 2729, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1993-01-05", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                105
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "1999-01-03", 
            "extra": null, 
            "id": 2730, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1997-01-07", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                106
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2001-01-03", 
            "extra": null, 
            "id": 2731, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "1999-01-06", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                107
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2003-01-03", 
            "extra": null, 
            "id": 2732, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2001-01-03", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                108
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2005-01-03", 
            "extra": null, 
            "id": 2733, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2003-01-07", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://www.house.gov/price"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                109
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2007-01-03", 
            "extra": null, 
            "id": 2734, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2005-01-04", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://www.house.gov/price"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                110
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2009-01-03", 
            "extra": null, 
            "id": 2735, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2007-01-04", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://price.house.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                111
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2011-01-03", 
            "extra": null, 
            "id": 2736, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": null, 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2009-01-06", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://price.house.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                112
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2013-01-03", 
            "extra": {
                "address": "2162 Rayburn HOB; Washington DC 20515-3304", 
                "contact_form": "http://price.house.gov/contact/contact_form.shtml", 
                "fax": "202-225-2014", 
                "office": "2162 Rayburn House Office Building"
            }, 
            "id": 2737, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": "202-225-1784", 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2011-01-05", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://price.house.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                113
            ], 
            "current": false, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2015-01-03", 
            "extra": {
                "address": "2162 Rayburn HOB; Washington DC 20515-3304", 
                "contact_form": "https://price.house.gov/contact", 
                "fax": "202-225-2014", 
                "office": "2162 Rayburn House Office Building", 
                "rss_url": "http://price.house.gov/index.php?format=feed&amp;type=rss"
            }, 
            "id": 42814, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": "202-225-1784", 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2013-01-03", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://price.house.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                114
            ], 
            "current": true, 
            "description": "Representative for North Carolina's 4th congressional district", 
            "district": 4, 
            "enddate": "2017-01-03", 
            "extra": {
                "address": "2108 Rayburn HOB; Washington DC 20515-3304", 
                "contact_form": "https://price.house.gov/contact", 
                "fax": "202-225-2014", 
                "office": "2108 Rayburn House Office Building", 
                "rss_url": "http://price.house.gov/index.php?format=feed&amp;type=rss"
            }, 
            "id": 43367, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": 400326, 
            "phone": "202-225-1784", 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2015-01-06", 
            "state": "NC", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://price.house.gov"
        }
    ], 
    "sortname": "Price, David (Rep.) [D-NC4]", 
    "twitterid": "RepDavidEPrice", 
    "youtubeid": "RepDavidPrice"
}

Fields

q
Filters according to a full-text search on the object.
Filterable (without operators).
bioguideid
The person's ID on bioguide.congress.gov. May be null if the person served only as a president and not in Congress.
birthday
The person's birthday.
committeeassignments
A list of CommitteeMember instances whose person field is this object. Each instance is returned as a JSON dict (or equivalent in other output formats). Only returned in a single-object query.
cspanid
The ID of the person on CSPAN websites, if known.
firstname
The person's first name or first initial.
gender
The person's gender, if known. For historical data, the gender is sometimes not known.
Filterable with operators. Sortable. To search for a null value, filter on the special string 'null'.
This field can take on the following values:
Value Notes
male Male
female Female
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
lastname
The person's last name.
link
The canonical URL of this resource.
middlename
The person's middle name (optional).
name
The person's full name with title, district, and party information for current Members of Congress, in a typical display format.
namemod
The suffix on the person's name usually one of Jr., Sr., I, II, etc.
nickname
The person's nickname. If set, the nickname should usually be displayed in quotes where a middle name would go. For instance, Joe "Buster" Smith.
osid
The person's ID on opensecrets.org (The Center for Responsive Politics), if known.
pvsid
The person's ID on vote-smart.org (Project Vote Smart), if known.
roles
A list of PersonRole instances whose person field is this object. Each instance is returned as a JSON dict (or equivalent in other output formats). Only returned in a single-object query.
sortname
The person's name suitable for sorting lexicographically by last name or for display in a sorted list of names. Title, district, and party information are included for current Members of Congress.
Filterable with operators. Sortable.
twitterid
The name of the person's official Twitter handle, if known.
youtubeid
The name of the person's official YouTube channel, if known.

Role

Terms held in office by Members of Congress, Presidents, and Vice Presidents. Each term corresponds with an election, meaning each term in the House covers two years (one 'Congress'), as President/Vice President four years, and in the Senate six years (three 'Congresses').

Use the list API at https://www.govtrack.us/api/v2/role to get a list of objects of this type.

{
    "meta": {
        "limit": 5, 
        "offset": 0, 
        "total_count": 542
    }, 
    "objects": [
        {
            "caucus": null, 
            "congress_numbers": [
                113, 
                114, 
                115
            ], 
            "current": true, 
            "description": "President of the United States", 
            "district": null, 
            "enddate": "2017-01-20", 
            "extra": {
                "how": "election"
            }, 
            "id": 43155, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": {
                "bioguideid": "O000167", 
                "birthday": "1961-08-04", 
                "cspanid": null, 
                "firstname": "Barack", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 400629, 
                "lastname": "Obama", 
                "link": "https://www.govtrack.us/congress/members/barack_obama/400629", 
                "middlename": "", 
                "name": "President Barack Obama [D]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00009638", 
                "pvsid": "9490", 
                "sortname": "Obama, Barack (President) [D]", 
                "twitterid": null, 
                "youtubeid": null
            }, 
            "phone": null, 
            "role_type": "president", 
            "role_type_label": "President", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2013-01-20", 
            "state": "", 
            "title": "President", 
            "title_long": "President of the United States", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                113, 
                114, 
                115
            ], 
            "current": true, 
            "description": "Vice President of the United States (and President of the Senate)", 
            "district": null, 
            "enddate": "2017-01-20", 
            "extra": {
                "how": "election"
            }, 
            "id": 43179, 
            "leadership_title": null, 
            "party": "Democrat", 
            "person": {
                "bioguideid": "B000444", 
                "birthday": "1942-11-20", 
                "cspanid": 34, 
                "firstname": "Joseph", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 300008, 
                "lastname": "Biden", 
                "link": "https://www.govtrack.us/congress/members/joseph_biden/300008", 
                "middlename": "R.", 
                "name": "Vice President Joseph Biden [D]", 
                "namemod": "Jr.", 
                "nickname": "", 
                "osid": "N00001669", 
                "pvsid": "53279", 
                "sortname": "Biden, Joseph (Vice President) [D]", 
                "twitterid": null, 
                "youtubeid": null
            }, 
            "phone": null, 
            "role_type": "vicepresident", 
            "role_type_label": "Vice President", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2013-01-20", 
            "state": "", 
            "title": "Vice President", 
            "title_long": "Vice President of the United States (and President of the Senate)", 
            "website": ""
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                112, 
                113, 
                114
            ], 
            "current": true, 
            "description": "Senior Senator from Alaska", 
            "district": null, 
            "enddate": "2017-01-03", 
            "extra": {
                "address": "709 Hart Senate Office Building Washington DC 20510", 
                "contact_form": "http://www.murkowski.senate.gov/public/index.cfm?p=EMailLisa", 
                "fax": "202-224-5301", 
                "office": "709 Hart Senate Office Building", 
                "rss_url": "http://www.murkowski.senate.gov/public/?a=rss.feed"
            }, 
            "id": 4209, 
            "leadership_title": null, 
            "party": "Republican", 
            "person": {
                "bioguideid": "M001153", 
                "birthday": "1957-05-22", 
                "cspanid": 1004138, 
                "firstname": "Lisa", 
                "gender": "female", 
                "gender_label": "Female", 
                "id": 300075, 
                "lastname": "Murkowski", 
                "link": "https://www.govtrack.us/congress/members/lisa_murkowski/300075", 
                "middlename": "A.", 
                "name": "Sen. Lisa Murkowski [R-AK]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00026050", 
                "pvsid": "15841", 
                "sortname": "Murkowski, Lisa (Sen.) [R-AK]", 
                "twitterid": "LisaMurkowski", 
                "youtubeid": "senatormurkowski"
            }, 
            "phone": "202-224-6665", 
            "role_type": "senator", 
            "role_type_label": "Senator", 
            "senator_class": "class3", 
            "senator_class_label": "Class 3", 
            "senator_rank": "senior", 
            "senator_rank_label": "Senior", 
            "startdate": "2011-01-05", 
            "state": "AK", 
            "title": "Sen.", 
            "title_long": "Senator", 
            "website": "https://www.murkowski.senate.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                114
            ], 
            "current": true, 
            "description": "Representative for Alaska At Large", 
            "district": 0, 
            "enddate": "2017-01-03", 
            "extra": {
                "address": "2314 Rayburn HOB; Washington DC 20515-0200", 
                "contact_form": "https://donyoung.house.gov/forms/writeyourrep/", 
                "fax": "202-225-0425", 
                "office": "2314 Rayburn House Office Building", 
                "rss_url": "http://donyoung.house.gov/news/rss.aspx"
            }, 
            "id": 43409, 
            "leadership_title": null, 
            "party": "Republican", 
            "person": {
                "bioguideid": "Y000033", 
                "birthday": "1933-06-09", 
                "cspanid": 1897, 
                "firstname": "Don", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 400440, 
                "lastname": "Young", 
                "link": "https://www.govtrack.us/congress/members/don_young/400440", 
                "middlename": "E.", 
                "name": "Rep. Don Young [R-AK0]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00007999", 
                "pvsid": "26717", 
                "sortname": "Young, Don (Rep.) [R-AK0]", 
                "twitterid": "RepDonYoung", 
                "youtubeid": "RepDonYoung"
            }, 
            "phone": "202-225-5765", 
            "role_type": "representative", 
            "role_type_label": "Representative", 
            "senator_class": null, 
            "senator_rank": null, 
            "startdate": "2015-01-06", 
            "state": "AK", 
            "title": "Rep.", 
            "title_long": "Representative", 
            "website": "http://donyoung.house.gov"
        }, 
        {
            "caucus": null, 
            "congress_numbers": [
                114, 
                115, 
                116
            ], 
            "current": true, 
            "description": "Junior Senator from Alaska", 
            "district": null, 
            "enddate": "2021-01-03", 
            "extra": {
                "address": "702 Hart Senate Office Building Washington DC 20510", 
                "office": "702 Hart Senate Office Building"
            }, 
            "id": 43726, 
            "leadership_title": null, 
            "party": "Republican", 
            "person": {
                "bioguideid": "S001198", 
                "birthday": "1964-11-13", 
                "cspanid": null, 
                "firstname": "Dan", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412665, 
                "lastname": "Sullivan", 
                "link": "https://www.govtrack.us/congress/members/dan_sullivan/412665", 
                "middlename": "", 
                "name": "Sen. Dan Sullivan [R-AK]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00035774", 
                "pvsid": null, 
                "sortname": "Sullivan, Dan (Sen.) [R-AK]", 
                "twitterid": "SenDanSullivan", 
                "youtubeid": null
            }, 
            "phone": "202-224-3004", 
            "role_type": "senator", 
            "role_type_label": "Senator", 
            "senator_class": "class2", 
            "senator_class_label": "Class 2", 
            "senator_rank": "junior", 
            "senator_rank_label": "Junior", 
            "startdate": "2015-01-06", 
            "state": "AK", 
            "title": "Sen.", 
            "title_long": "Senator", 
            "website": "http://www.sullivan.senate.gov"
        }
    ]
}

Fields

caucus
For independents, the party that the legislator caucuses with. If changed during a term, the most recent.
congress_numbers
The Congressional sessions (Congress numbers) that this role spans, as a list from the starting Congress number through consecutive numbers to the ending Congress number.
current
Whether the role is currently held, or if this is archival information.
Filterable with operators. Sortable.
description
A description of this role, e.g. Delegate for District of Columbia At Large.
district
For representatives, the number of their congressional district. 0 for at-large districts, -1 in historical data if the district is not known.
Filterable with operators. Sortable. To search for a null value, filter on the special string 'null'.
enddate
The date the role ended (when the person resigned, died, etc.)
Filterable with operators. Sortable.
extra
Additional schema-less information stored with this object.
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
leadership_title
The last known leadership role held during this role, if any.
party
The political party of the person. If the person changes party, it is usually the most recent party during this role.
Filterable with operators. Sortable. To search for a null value, filter on the special string 'null'.
person
The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object.
phone
The last known phone number of the DC congressional office during this role, if known.
role_type
The type of this role: a U.S. senator, a U.S. congressperson, a U.S. president, or a U.S. vice president.
Filterable with operators. Sortable.
This field can take on the following values:
Value Notes
senator Senator
vicepresident Vice President
representative Representative
president President
senator_class
For senators, their election class, which determines which years they are up for election. (It has nothing to do with seniority.)
Filterable with operators. Sortable. To search for a null value, filter on the special string 'null'.
This field can take on the following values:
Value Notes
class2 Class 2
class3 Class 3
class1 Class 1
senator_rank
For senators, their state rank, i.e. junior or senior. For historical data, this is their last known rank.
This field can take on the following values:
Value Notes
senior Senior
junior Junior
startdate
The date the role began (when the person took office).
Filterable with operators. Sortable.
state
For senators and representatives, the two-letter USPS abbrevation for the state or territory they are serving. Values are the abbreviations for the 50 states (each of which have at least one representative and two senators, assuming no vacancies) plus DC, PR, and the island territories AS, GU, MP, and VI (all of which have a non-voting delegate), and for really old historical data you will also find PI (Philippines, 1907-1946), DK (Dakota Territory, 1861-1889), and OR (Orleans Territory, 1806-1811) for non-voting delegates.
Filterable with operators. Sortable.
title
The title used to prefix the names of people with this role: Rep., Sen., President, Del. (delegate), or Commish. (resident commissioner).
title_long
The long form of the title used to prefix the names of people with this role: Representative, Senator, President, Delegate, or Resident Commissioner.
website
The URL to the official website of the person during this role, if known.

Vote

Roll call votes in the U.S. Congress since 1789. How people voted is accessed through the Vote_voter API.

Use the list API at https://www.govtrack.us/api/v2/vote to get a list of objects of this type.

{
    "meta": {
        "limit": 5, 
        "offset": 0, 
        "total_count": 104682
    }, 
    "objects": [
        {
            "category": "passage_suspension", 
            "category_label": "Passage under Suspension", 
            "chamber": "house", 
            "chamber_label": "House", 
            "congress": 114, 
            "created": "2016-09-22T21:32:00", 
            "id": 118777, 
            "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
            "margin": 0.89372, 
            "missing_data": false, 
            "number": 556, 
            "options": [
                {
                    "id": 458001, 
                    "key": "+", 
                    "value": "Yea", 
                    "vote": 118777
                }, 
                {
                    "id": 458002, 
                    "key": "-", 
                    "value": "Nay", 
                    "vote": 118777
                }, 
                {
                    "id": 458003, 
                    "key": "P", 
                    "value": "Present", 
                    "vote": 118777
                }, 
                {
                    "id": 458004, 
                    "key": "0", 
                    "value": "Not Voting", 
                    "vote": 118777
                }
            ], 
            "percent_plus": 0.909513, 
            "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
            "question_details": "On Motion to Suspend the Rules and Pass in the House", 
            "related_amendment": null, 
            "related_bill": {
                "bill_resolution_type": "bill", 
                "bill_type": "house_bill", 
                "bill_type_label": "H.R.", 
                "congress": 114, 
                "current_status": "pass_over_house", 
                "current_status_date": "2016-09-22", 
                "current_status_description": "This bill passed in the House on September 22, 2016 and goes to the Senate next for consideration.", 
                "current_status_label": "Passed House", 
                "display_number": "H.R. 5798", 
                "docs_house_gov_postdate": "2016-09-16T18:05:16", 
                "id": 346009, 
                "introduced_date": "2016-07-14", 
                "is_alive": true, 
                "is_current": true, 
                "link": "https://www.govtrack.us/congress/bills/114/hr5798", 
                "lock_title": false, 
                "major_actions": [
                    [
                        "datetime.datetime(2016, 7, 14, 0, 0)", 
                        2, 
                        "Referred to the House Committee on Oversight and Government Reform.", 
                        "<action datetime=\"2016-07-14\" state=\"REFERRED\">\n      <text>Referred to the House Committee on Oversight and Government Reform.</text>\n    </action>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 15, 0, 0)", 
                        3, 
                        "Ordered to be Reported by Unanimous Consent.", 
                        "<calendar datetime=\"2016-09-15\" state=\"REPORTED\">\n      <text>Ordered to be Reported by Unanimous Consent.</text>\n    </calendar>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 22, 21, 33, 34)", 
                        4, 
                        "On motion to suspend the rules and pass the bill Agreed to by the Yeas and Nays: (2/3 required): 392 - 22, 1 Present (Roll no. 556).", 
                        "<vote how=\"roll\" type=\"vote\" roll=\"556\" datetime=\"2016-09-22T21:33:34-04:00\" where=\"h\" result=\"pass\" suspension=\"1\" state=\"PASS_OVER:HOUSE\">\n      <text>On motion to suspend the rules and pass the bill Agreed to by the Yeas and Nays: (2/3 required): 392 - 22, 1 Present (Roll no. 556).</text>\n    </vote>\n    "
                    ]
                ], 
                "noun": "bill", 
                "number": 5798, 
                "related_bills": [], 
                "senate_floor_schedule_postdate": null, 
                "sliplawnum": null, 
                "sliplawpubpriv": null, 
                "source": "thomas-congproj", 
                "source_link": null, 
                "sponsor": 400360, 
                "sponsor_role": 43381, 
                "title": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "title_without_number": "To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "titles": [
                    [
                        "official", 
                        "introduced", 
                        "To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the \"Abner J. Mikva Post Office Building\"."
                    ], 
                    [
                        "display", 
                        null, 
                        "To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the \"Abner J. Mikva Post Office Building\"."
                    ]
                ]
            }, 
            "required": "2/3", 
            "result": "Passed", 
            "session": "2016", 
            "source": "house", 
            "source_label": "house.gov", 
            "total_minus": 22, 
            "total_other": 17, 
            "total_plus": 392, 
            "vote_type": "On Motion to Suspend the Rules and Pass"
        }, 
        {
            "category": "passage_suspension", 
            "category_label": "Passage under Suspension", 
            "chamber": "house", 
            "chamber_label": "House", 
            "congress": 114, 
            "created": "2016-09-22T21:26:00", 
            "id": 118779, 
            "link": "https://www.govtrack.us/congress/votes/114-2016/h555", 
            "margin": 0.995169, 
            "missing_data": false, 
            "number": 555, 
            "options": [
                {
                    "id": 458009, 
                    "key": "+", 
                    "value": "Yea", 
                    "vote": 118779
                }, 
                {
                    "id": 458010, 
                    "key": "-", 
                    "value": "Nay", 
                    "vote": 118779
                }, 
                {
                    "id": 458011, 
                    "key": "P", 
                    "value": "Present", 
                    "vote": 118779
                }, 
                {
                    "id": 458012, 
                    "key": "0", 
                    "value": "Not Voting", 
                    "vote": 118779
                }
            ], 
            "percent_plus": 0.958237, 
            "question": "H.R. 5037: District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act", 
            "question_details": "On Motion to Suspend the Rules and Pass, as Amended in the House", 
            "related_amendment": null, 
            "related_bill": {
                "bill_resolution_type": "bill", 
                "bill_type": "house_bill", 
                "bill_type_label": "H.R.", 
                "congress": 114, 
                "current_status": "pass_over_house", 
                "current_status_date": "2016-09-22", 
                "current_status_description": "This bill passed in the House on September 22, 2016 and goes to the Senate next for consideration.", 
                "current_status_label": "Passed House", 
                "display_number": "H.R. 5037", 
                "docs_house_gov_postdate": "2016-09-16T18:05:16", 
                "id": 344592, 
                "introduced_date": "2016-04-21", 
                "is_alive": true, 
                "is_current": true, 
                "link": "https://www.govtrack.us/congress/bills/114/hr5037", 
                "lock_title": false, 
                "major_actions": [
                    [
                        "datetime.datetime(2016, 4, 21, 0, 0)", 
                        2, 
                        "Referred to the House Committee on Oversight and Government Reform.", 
                        "<action datetime=\"2016-04-21\" state=\"REFERRED\">\n      <text>Referred to the House Committee on Oversight and Government Reform.</text>\n    </action>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 7, 12, 0, 0)", 
                        3, 
                        "Ordered to be Reported (Amended) by Voice Vote.", 
                        "<calendar datetime=\"2016-07-12\" state=\"REPORTED\">\n      <text>Ordered to be Reported (Amended) by Voice Vote.</text>\n    </calendar>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 22, 21, 27, 15)", 
                        4, 
                        "On motion to suspend the rules and pass the bill, as amended Agreed to by the Yeas and Nays: (2/3 required): 413 - 1 (Roll no. 555).", 
                        "<vote how=\"roll\" type=\"vote\" roll=\"555\" datetime=\"2016-09-22T21:27:15-04:00\" where=\"h\" result=\"pass\" suspension=\"1\" state=\"PASS_OVER:HOUSE\">\n      <text>On motion to suspend the rules and pass the bill, as amended Agreed to by the Yeas and Nays: (2/3 required): 413 - 1 (Roll no. 555).</text>\n    </vote>\n    "
                    ]
                ], 
                "noun": "bill", 
                "number": 5037, 
                "related_bills": [], 
                "senate_floor_schedule_postdate": null, 
                "sliplawnum": null, 
                "sliplawpubpriv": null, 
                "source": "thomas-congproj", 
                "source_link": null, 
                "sponsor": 400295, 
                "sponsor_role": 43359, 
                "title": "H.R. 5037: District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act", 
                "title_without_number": "District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act", 
                "titles": [
                    [
                        "short", 
                        "introduced", 
                        "District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act"
                    ], 
                    [
                        "short", 
                        "reported to house", 
                        "District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act"
                    ], 
                    [
                        "official", 
                        "introduced", 
                        "To authorize the establishment of a program of voluntary separation incentive payments for nonjudicial employees of the District of Columbia courts and employees of the District of Columbia Public Defender Service."
                    ], 
                    [
                        "display", 
                        null, 
                        "District of Columbia Courts and Public Defender Service Voluntary Separation Incentive Payments Act"
                    ]
                ]
            }, 
            "required": "2/3", 
            "result": "Passed", 
            "session": "2016", 
            "source": "house", 
            "source_label": "house.gov", 
            "total_minus": 1, 
            "total_other": 17, 
            "total_plus": 413, 
            "vote_type": "On Motion to Suspend the Rules and Pass, as Amended"
        }, 
        {
            "category": "passage", 
            "category_label": "Passage", 
            "chamber": "house", 
            "chamber_label": "House", 
            "congress": 114, 
            "created": "2016-09-22T21:19:00", 
            "id": 118778, 
            "link": "https://www.govtrack.us/congress/votes/114-2016/h554", 
            "margin": 0.218225, 
            "missing_data": false, 
            "number": 554, 
            "options": [
                {
                    "id": 458005, 
                    "key": "+", 
                    "value": "Aye", 
                    "vote": 118778
                }, 
                {
                    "id": 458006, 
                    "key": "-", 
                    "value": "No", 
                    "vote": 118778
                }, 
                {
                    "id": 458007, 
                    "key": "P", 
                    "value": "Present", 
                    "vote": 118778
                }, 
                {
                    "id": 458008, 
                    "key": "0", 
                    "value": "Not Voting", 
                    "vote": 118778
                }
            ], 
            "percent_plus": 0.589327, 
            "question": "H.R. 5931: Prohibiting Future Ransom Payments to Iran Act", 
            "question_details": "On Passage of the Bill in the House", 
            "related_amendment": null, 
            "related_bill": {
                "bill_resolution_type": "bill", 
                "bill_type": "house_bill", 
                "bill_type_label": "H.R.", 
                "congress": 114, 
                "current_status": "pass_over_house", 
                "current_status_date": "2016-09-22", 
                "current_status_description": "This bill passed in the House on September 22, 2016 and goes to the Senate next for consideration.", 
                "current_status_label": "Passed House", 
                "display_number": "H.R. 5931", 
                "docs_house_gov_postdate": "2016-09-16T10:15:32", 
                "id": 346256, 
                "introduced_date": "2016-09-06", 
                "is_alive": true, 
                "is_current": true, 
                "link": "https://www.govtrack.us/congress/bills/114/hr5931", 
                "lock_title": false, 
                "major_actions": [
                    [
                        "datetime.datetime(2016, 9, 6, 0, 0)", 
                        2, 
                        "Referred to the House Committee on Foreign Affairs.", 
                        "<action datetime=\"2016-09-06\" state=\"REFERRED\">\n      <text>Referred to the House Committee on Foreign Affairs.</text>\n    </action>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 14, 0, 0)", 
                        3, 
                        "Ordered to be Reported (Amended) by Voice Vote.", 
                        "<calendar datetime=\"2016-09-14\" state=\"REPORTED\">\n      <text>Ordered to be Reported (Amended) by Voice Vote.</text>\n    </calendar>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 22, 21, 20, 33)", 
                        4, 
                        "On passage Passed by recorded vote: 254 - 163 (Roll no. 554).", 
                        "<vote how=\"roll\" type=\"vote\" roll=\"554\" datetime=\"2016-09-22T21:20:33-04:00\" where=\"h\" result=\"pass\" state=\"PASS_OVER:HOUSE\">\n      <text>On passage Passed by recorded vote: 254 - 163 (Roll no. 554).</text>\n    </vote>\n    "
                    ]
                ], 
                "noun": "bill", 
                "number": 5931, 
                "related_bills": [
                    {
                        "bill": 346590, 
                        "relation": "procedurally-rel"
                    }
                ], 
                "senate_floor_schedule_postdate": null, 
                "sliplawnum": null, 
                "sliplawpubpriv": null, 
                "source": "thomas-congproj", 
                "source_link": null, 
                "sponsor": 400348, 
                "sponsor_role": 43374, 
                "title": "H.R. 5931: Prohibiting Future Ransom Payments to Iran Act", 
                "title_without_number": "Prohibiting Future Ransom Payments to Iran Act", 
                "titles": [
                    [
                        "short", 
                        "introduced", 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ], 
                    [
                        "short", 
                        "reported to house", 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ], 
                    [
                        "official", 
                        "introduced", 
                        "To provide for the prohibition on cash payments to the Government of Iran, and for other purposes."
                    ], 
                    [
                        "display", 
                        null, 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ]
                ]
            }, 
            "required": "1/2", 
            "result": "Passed", 
            "session": "2016", 
            "source": "house", 
            "source_label": "house.gov", 
            "total_minus": 163, 
            "total_other": 14, 
            "total_plus": 254, 
            "vote_type": "On Passage of the Bill"
        }, 
        {
            "category": "amendment", 
            "category_label": "Amendment", 
            "chamber": "house", 
            "chamber_label": "House", 
            "congress": 114, 
            "created": "2016-09-22T21:11:00", 
            "id": 118776, 
            "link": "https://www.govtrack.us/congress/votes/114-2016/h553", 
            "margin": 0.149758, 
            "missing_data": false, 
            "number": 553, 
            "options": [
                {
                    "id": 457997, 
                    "key": "+", 
                    "value": "Aye", 
                    "vote": 118776
                }, 
                {
                    "id": 457998, 
                    "key": "-", 
                    "value": "No", 
                    "vote": 118776
                }, 
                {
                    "id": 457999, 
                    "key": "P", 
                    "value": "Present", 
                    "vote": 118776
                }, 
                {
                    "id": 458000, 
                    "key": "0", 
                    "value": "Not Voting", 
                    "vote": 118776
                }
            ], 
            "percent_plus": 0.408353, 
            "question": "H.Amdt. 1433 (Engel) to H.R. 5931: To require the President to notify Congress of a payment made to any State Sponsor of Terrorism or North Korea pursuant to a settlement or judgment against the United States. The amendment requires the President to repo", 
            "question_details": "On the Amendment in the House", 
            "related_amendment": 99192, 
            "related_bill": {
                "bill_resolution_type": "bill", 
                "bill_type": "house_bill", 
                "bill_type_label": "H.R.", 
                "congress": 114, 
                "current_status": "pass_over_house", 
                "current_status_date": "2016-09-22", 
                "current_status_description": "This bill passed in the House on September 22, 2016 and goes to the Senate next for consideration.", 
                "current_status_label": "Passed House", 
                "display_number": "H.R. 5931", 
                "docs_house_gov_postdate": "2016-09-16T10:15:32", 
                "id": 346256, 
                "introduced_date": "2016-09-06", 
                "is_alive": true, 
                "is_current": true, 
                "link": "https://www.govtrack.us/congress/bills/114/hr5931", 
                "lock_title": false, 
                "major_actions": [
                    [
                        "datetime.datetime(2016, 9, 6, 0, 0)", 
                        2, 
                        "Referred to the House Committee on Foreign Affairs.", 
                        "<action datetime=\"2016-09-06\" state=\"REFERRED\">\n      <text>Referred to the House Committee on Foreign Affairs.</text>\n    </action>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 14, 0, 0)", 
                        3, 
                        "Ordered to be Reported (Amended) by Voice Vote.", 
                        "<calendar datetime=\"2016-09-14\" state=\"REPORTED\">\n      <text>Ordered to be Reported (Amended) by Voice Vote.</text>\n    </calendar>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 22, 21, 20, 33)", 
                        4, 
                        "On passage Passed by recorded vote: 254 - 163 (Roll no. 554).", 
                        "<vote how=\"roll\" type=\"vote\" roll=\"554\" datetime=\"2016-09-22T21:20:33-04:00\" where=\"h\" result=\"pass\" state=\"PASS_OVER:HOUSE\">\n      <text>On passage Passed by recorded vote: 254 - 163 (Roll no. 554).</text>\n    </vote>\n    "
                    ]
                ], 
                "noun": "bill", 
                "number": 5931, 
                "related_bills": [
                    {
                        "bill": 346590, 
                        "relation": "procedurally-rel"
                    }
                ], 
                "senate_floor_schedule_postdate": null, 
                "sliplawnum": null, 
                "sliplawpubpriv": null, 
                "source": "thomas-congproj", 
                "source_link": null, 
                "sponsor": 400348, 
                "sponsor_role": 43374, 
                "title": "H.R. 5931: Prohibiting Future Ransom Payments to Iran Act", 
                "title_without_number": "Prohibiting Future Ransom Payments to Iran Act", 
                "titles": [
                    [
                        "short", 
                        "introduced", 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ], 
                    [
                        "short", 
                        "reported to house", 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ], 
                    [
                        "official", 
                        "introduced", 
                        "To provide for the prohibition on cash payments to the Government of Iran, and for other purposes."
                    ], 
                    [
                        "display", 
                        null, 
                        "Prohibiting Future Ransom Payments to Iran Act"
                    ]
                ]
            }, 
            "required": "1/2", 
            "result": "Failed", 
            "session": "2016", 
            "source": "house", 
            "source_label": "house.gov", 
            "total_minus": 238, 
            "total_other": 17, 
            "total_plus": 176, 
            "vote_type": "On the Amendment"
        }, 
        {
            "category": "passage_suspension", 
            "category_label": "Passage under Suspension", 
            "chamber": "house", 
            "chamber_label": "House", 
            "congress": 114, 
            "created": "2016-09-22T17:55:00", 
            "id": 118771, 
            "link": "https://www.govtrack.us/congress/votes/114-2016/h552", 
            "margin": 0.858881, 
            "missing_data": false, 
            "number": 552, 
            "options": [
                {
                    "id": 457977, 
                    "key": "+", 
                    "value": "Yea", 
                    "vote": 118771
                }, 
                {
                    "id": 457978, 
                    "key": "-", 
                    "value": "Nay", 
                    "vote": 118771
                }, 
                {
                    "id": 457979, 
                    "key": "P", 
                    "value": "Present", 
                    "vote": 118771
                }, 
                {
                    "id": 457980, 
                    "key": "0", 
                    "value": "Not Voting", 
                    "vote": 118771
                }
            ], 
            "percent_plus": 0.886311, 
            "question": "H.R. 5963: Supporting Youth Opportunity and Preventing Delinquency Act of 2016", 
            "question_details": "On Motion to Suspend the Rules and Pass, as Amended in the House", 
            "related_amendment": null, 
            "related_bill": {
                "bill_resolution_type": "bill", 
                "bill_type": "house_bill", 
                "bill_type_label": "H.R.", 
                "congress": 114, 
                "current_status": "pass_over_house", 
                "current_status_date": "2016-09-22", 
                "current_status_description": "This bill passed in the House on September 22, 2016 and goes to the Senate next for consideration.", 
                "current_status_label": "Passed House", 
                "display_number": "H.R. 5963", 
                "docs_house_gov_postdate": "2016-09-16T18:05:16", 
                "id": 346312, 
                "introduced_date": "2016-09-08", 
                "is_alive": true, 
                "is_current": true, 
                "link": "https://www.govtrack.us/congress/bills/114/hr5963", 
                "lock_title": false, 
                "major_actions": [
                    [
                        "datetime.datetime(2016, 9, 8, 0, 0)", 
                        2, 
                        "Referred to the House Committee on Education and the Workforce.", 
                        "<action datetime=\"2016-09-08\" state=\"REFERRED\">\n      <text>Referred to the House Committee on Education and the Workforce.</text>\n    </action>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 14, 0, 0)", 
                        3, 
                        "Ordered to be Reported by Voice Vote.", 
                        "<calendar datetime=\"2016-09-14\" state=\"REPORTED\">\n      <text>Ordered to be Reported by Voice Vote.</text>\n    </calendar>\n    "
                    ], 
                    [
                        "datetime.datetime(2016, 9, 22, 17, 56, 37)", 
                        4, 
                        "On motion to suspend the rules and pass the bill, as amended Agreed to by the Yeas and Nays: (2/3 required): 382 - 29 (Roll no. 552).", 
                        "<vote how=\"roll\" type=\"vote\" roll=\"552\" datetime=\"2016-09-22T17:56:37-04:00\" where=\"h\" result=\"pass\" suspension=\"1\" state=\"PASS_OVER:HOUSE\">\n      <text>On motion to suspend the rules and pass the bill, as amended Agreed to by the Yeas and Nays: (2/3 required): 382 - 29 (Roll no. 552).</text>\n    </vote>\n    "
                    ]
                ], 
                "noun": "bill", 
                "number": 5963, 
                "related_bills": [
                    {
                        "bill": 339081, 
                        "relation": "unknown"
                    }
                ], 
                "senate_floor_schedule_postdate": null, 
                "sliplawnum": null, 
                "sliplawpubpriv": null, 
                "source": "thomas-congproj", 
                "source_link": null, 
                "sponsor": 412621, 
                "sponsor_role": 43682, 
                "title": "H.R. 5963: Supporting Youth Opportunity and Preventing Delinquency Act of 2016", 
                "title_without_number": "Supporting Youth Opportunity and Preventing Delinquency Act of 2016", 
                "titles": [
                    [
                        "short", 
                        "introduced", 
                        "Supporting Youth Opportunity and Preventing Delinquency Act of 2016"
                    ], 
                    [
                        "official", 
                        "introduced", 
                        "To reauthorize and improve the Juvenile Justice and Delinquency Prevention Act of 1974, and for other purposes."
                    ], 
                    [
                        "display", 
                        null, 
                        "Supporting Youth Opportunity and Preventing Delinquency Act of 2016"
                    ]
                ]
            }, 
            "required": "2/3", 
            "result": "Passed", 
            "session": "2016", 
            "source": "house", 
            "source_label": "house.gov", 
            "total_minus": 29, 
            "total_other": 20, 
            "total_plus": 382, 
            "vote_type": "On Motion to Suspend the Rules and Pass, as Amended"
        }
    ]
}

Fields

category
The type of the vote.
This field can take on the following values:
Value Notes
amendment Amendment
Votes on accepting or rejecting amendments to bills and resolutions.
conviction Conviction
'Guilty or Not Guilty' votes in the Senate to convict an office holder following impeachment.
veto_override Veto Override
Votes to override a presidential veto.
unknown Unknown Category
A variety of uncategorized votes.
impeachment Impeachment
A vote in the House on whether or not to impeach an office-holder.
passage_suspension Passage under Suspension
Fast-tracked votes on the passage of bills requiring a 2/3rds majority.
passage_part Passage (Part)
Votes on the passage of parts of legislation.
other Other
A variety of uncategorized votes.
ratification Treaty Ratification
Senate votes to ratify treaties.
cloture Cloture
Votes to end debate and move to a vote, i.e. to end a filibuster.
passage Passage
Votes on passing or failing bills and resolutions and on agreeing to conference reports.
nomination Nomination
Senate votes on presidential nominations.
procedural Procedural
A variety of procedural votes such as quorum calls.
chamber
The chamber in which the vote was held, House or Senate.
Filterable when also filtering on congress.
This field can take on the following values:
Value Notes
senate Senate
house House
congress
The number of the Congress in which the vote took place. The current Congress is 114. In recent history Congresses are two years; however, this was not always the case.
Filterable.
created
The date (and in recent history also time) on which the vote was held.
Filterable with operators. Sortable.
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
link
The canonical URL of this resource.
margin
The absolute value of the difference in the percent of positive votes and negative votes. Null for votes that aren't yes/no (like election of the speaker, quorum calls).
missing_data
If something in the source could be parsed and we should revisit the file.
number
The number of the vote, unique to a Congress, session, and chamber.
Filterable when also filtering on congress and chamber and session.
options
A list of VoteOption instances whose vote field is this object. Each instance is returned as a JSON dict (or equivalent in other output formats).
percent_plus
The percent of positive votes. Null for votes that aren't yes/no (like election of the speaker, quorum calls).
question
Descriptive text for what the vote was about.
question_details
Additional descriptive text for what the vote was about.
related_amendment
A related amendment. Returned as an integer ID.
Filterable with operators. Sortable. To search for a null value, filter on the special string 'null'.
related_bill
A related bill. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object. To search for a null value, filter on the special string 'null'.
required
A code indicating what number of votes was required for success. Often '1/2' or '3/5'. This field should be interpreted with care. It comes directly from the upstream source and may need some 'unpacking.' For instance, while 1/2 always mean 1/2 of those voting (i.e. excluding absent and abstain), 3/5 in some cases means to include absent/abstain and in other cases to exclude.
result
Descriptive text for the result of the vote.
session
Within each Congress there are sessions. In recent history the sessions correspond to calendar years and are named accordingly. However, in historical data the sessions may be named in completely other ways, such as with letters A, B, and C. Session names are unique *within* a Congress.
Filterable when also filtering on congress and chamber.
source
The source of the vote information.
This field can take on the following values:
Value Notes
senate senate.gov
house house.gov
keithpoole VoteView.com
total_minus
The count of negative votes (nay/no).
total_other
The count of abstain or absent voters.
total_plus
The count of positive votes (aye/yea).
vote_type
Descriptive text for the type of the vote.

Vote_voter

How people voted on roll call votes in the U.S. Congress since 1789. See the Vote API. Filter on the vote field to get the results of a particular vote.

Use the list API at https://www.govtrack.us/api/v2/vote_voter to get a list of objects of this type.

{
    "meta": {
        "limit": 5, 
        "offset": 0, 
        "total_count": 23773511
    }, 
    "objects": [
        {
            "created": "2016-09-22T21:32:00", 
            "id": 31459574, 
            "option": {
                "id": 458004, 
                "key": "0", 
                "value": "Not Voting", 
                "vote": 118777
            }, 
            "person": {
                "bioguideid": "W000820", 
                "birthday": "1962-05-14", 
                "cspanid": null, 
                "firstname": "Mimi", 
                "gender": "female", 
                "gender_label": "Female", 
                "id": 412618, 
                "lastname": "Walters", 
                "link": "https://www.govtrack.us/congress/members/mimi_walters/412618", 
                "middlename": "", 
                "name": "Rep. Mimi Walters [R-CA45]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00035391", 
                "pvsid": null, 
                "sortname": "Walters, Mimi (Rep.) [R-CA45]", 
                "twitterid": "RepMimiWalters", 
                "youtubeid": null
            }, 
            "person_role": {
                "caucus": null, 
                "congress_numbers": [
                    114
                ], 
                "current": true, 
                "description": "Representative for California's 45th congressional district", 
                "district": 45, 
                "enddate": "2017-01-03", 
                "extra": {
                    "address": "236 Cannon HOB; Washington DC 20515-0545", 
                    "fax": "202-225-9177", 
                    "office": "236 Cannon House Office Building"
                }, 
                "id": 43679, 
                "leadership_title": null, 
                "party": "Republican", 
                "person": 412618, 
                "phone": "202-225-5611", 
                "role_type": "representative", 
                "role_type_label": "Representative", 
                "senator_class": null, 
                "senator_rank": null, 
                "startdate": "2015-01-06", 
                "state": "CA", 
                "title": "Rep.", 
                "title_long": "Representative", 
                "website": "https://walters.house.gov"
            }, 
            "vote": {
                "category": "passage_suspension", 
                "category_label": "Passage under Suspension", 
                "chamber": "house", 
                "chamber_label": "House", 
                "congress": 114, 
                "created": "2016-09-22T21:32:00", 
                "id": 118777, 
                "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
                "margin": 0.89372, 
                "missing_data": false, 
                "number": 556, 
                "percent_plus": 0.909513, 
                "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "question_details": "On Motion to Suspend the Rules and Pass in the House", 
                "related_amendment": null, 
                "related_bill": 346009, 
                "required": "2/3", 
                "result": "Passed", 
                "session": "2016", 
                "source": "house", 
                "source_label": "house.gov", 
                "total_minus": 22, 
                "total_other": 17, 
                "total_plus": 392, 
                "vote_type": "On Motion to Suspend the Rules and Pass"
            }, 
            "voter_type": "member", 
            "voter_type_label": "Member of Congress", 
            "voteview_extra_code": ""
        }, 
        {
            "created": "2016-09-22T21:32:00", 
            "id": 31459573, 
            "option": {
                "id": 458004, 
                "key": "0", 
                "value": "Not Voting", 
                "vote": 118777
            }, 
            "person": {
                "bioguideid": "S000030", 
                "birthday": "1960-01-07", 
                "cspanid": 45639, 
                "firstname": "Loretta", 
                "gender": "female", 
                "gender_label": "Female", 
                "id": 400356, 
                "lastname": "Sanchez", 
                "link": "https://www.govtrack.us/congress/members/loretta_sanchez/400356", 
                "middlename": "B.", 
                "name": "Rep. Loretta Sanchez [D-CA46]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00008274", 
                "pvsid": "203", 
                "sortname": "Sanchez, Loretta (Rep.) [D-CA46]", 
                "twitterid": "LorettaSanchez", 
                "youtubeid": "LorettaSanchezLive"
            }, 
            "person_role": {
                "caucus": null, 
                "congress_numbers": [
                    114
                ], 
                "current": true, 
                "description": "Representative for California's 46th congressional district", 
                "district": 46, 
                "enddate": "2017-01-03", 
                "extra": {
                    "address": "1211 Longworth HOB; Washington DC 20515-0546", 
                    "contact_form": "https://lorettasanchez.house.gov/contact-me/email-me", 
                    "fax": "202-225-5859", 
                    "office": "1211 Longworth House Office Building", 
                    "rss_url": "http://lorettasanchez.house.gov/rss.xml"
                }, 
                "id": 43380, 
                "leadership_title": null, 
                "party": "Democrat", 
                "person": 400356, 
                "phone": "202-225-2965", 
                "role_type": "representative", 
                "role_type_label": "Representative", 
                "senator_class": null, 
                "senator_rank": null, 
                "startdate": "2015-01-06", 
                "state": "CA", 
                "title": "Rep.", 
                "title_long": "Representative", 
                "website": "http://lorettasanchez.house.gov"
            }, 
            "vote": {
                "category": "passage_suspension", 
                "category_label": "Passage under Suspension", 
                "chamber": "house", 
                "chamber_label": "House", 
                "congress": 114, 
                "created": "2016-09-22T21:32:00", 
                "id": 118777, 
                "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
                "margin": 0.89372, 
                "missing_data": false, 
                "number": 556, 
                "percent_plus": 0.909513, 
                "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "question_details": "On Motion to Suspend the Rules and Pass in the House", 
                "related_amendment": null, 
                "related_bill": 346009, 
                "required": "2/3", 
                "result": "Passed", 
                "session": "2016", 
                "source": "house", 
                "source_label": "house.gov", 
                "total_minus": 22, 
                "total_other": 17, 
                "total_plus": 392, 
                "vote_type": "On Motion to Suspend the Rules and Pass"
            }, 
            "voter_type": "member", 
            "voter_type_label": "Member of Congress", 
            "voteview_extra_code": ""
        }, 
        {
            "created": "2016-09-22T21:32:00", 
            "id": 31459572, 
            "option": {
                "id": 458004, 
                "key": "0", 
                "value": "Not Voting", 
                "vote": 118777
            }, 
            "person": {
                "bioguideid": "R000515", 
                "birthday": "1946-11-23", 
                "cspanid": 26127, 
                "firstname": "Bobby", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 400350, 
                "lastname": "Rush", 
                "link": "https://www.govtrack.us/congress/members/bobby_rush/400350", 
                "middlename": "L.", 
                "name": "Rep. Bobby Rush [D-IL1]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00004887", 
                "pvsid": "26831", 
                "sortname": "Rush, Bobby (Rep.) [D-IL1]", 
                "twitterid": "RepBobbyRush", 
                "youtubeid": "CongressmanRush"
            }, 
            "person_role": {
                "caucus": null, 
                "congress_numbers": [
                    114
                ], 
                "current": true, 
                "description": "Representative for Illinois's 1st congressional district", 
                "district": 1, 
                "enddate": "2017-01-03", 
                "extra": {
                    "address": "2188 Rayburn HOB; Washington DC 20515-1301", 
                    "contact_form": "https://rush.house.gov/contact-me/legislative-issues", 
                    "fax": "202-226-0333", 
                    "office": "2188 Rayburn House Office Building", 
                    "rss_url": "http://rush.house.gov/rss.xml"
                }, 
                "id": 43376, 
                "leadership_title": null, 
                "party": "Democrat", 
                "person": 400350, 
                "phone": "202-225-4372", 
                "role_type": "representative", 
                "role_type_label": "Representative", 
                "senator_class": null, 
                "senator_rank": null, 
                "startdate": "2015-01-06", 
                "state": "IL", 
                "title": "Rep.", 
                "title_long": "Representative", 
                "website": "http://rush.house.gov"
            }, 
            "vote": {
                "category": "passage_suspension", 
                "category_label": "Passage under Suspension", 
                "chamber": "house", 
                "chamber_label": "House", 
                "congress": 114, 
                "created": "2016-09-22T21:32:00", 
                "id": 118777, 
                "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
                "margin": 0.89372, 
                "missing_data": false, 
                "number": 556, 
                "percent_plus": 0.909513, 
                "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "question_details": "On Motion to Suspend the Rules and Pass in the House", 
                "related_amendment": null, 
                "related_bill": 346009, 
                "required": "2/3", 
                "result": "Passed", 
                "session": "2016", 
                "source": "house", 
                "source_label": "house.gov", 
                "total_minus": 22, 
                "total_other": 17, 
                "total_plus": 392, 
                "vote_type": "On Motion to Suspend the Rules and Pass"
            }, 
            "voter_type": "member", 
            "voter_type_label": "Member of Congress", 
            "voteview_extra_code": ""
        }, 
        {
            "created": "2016-09-22T21:32:00", 
            "id": 31459571, 
            "option": {
                "id": 458004, 
                "key": "0", 
                "value": "Not Voting", 
                "vote": 118777
            }, 
            "person": {
                "bioguideid": "P000592", 
                "birthday": "1948-09-10", 
                "cspanid": 1011398, 
                "firstname": "Ted", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 400652, 
                "lastname": "Poe", 
                "link": "https://www.govtrack.us/congress/members/ted_poe/400652", 
                "middlename": "", 
                "name": "Rep. Ted Poe [R-TX2]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00026457", 
                "pvsid": "49198", 
                "sortname": "Poe, Ted (Rep.) [R-TX2]", 
                "twitterid": "JudgeTedPoe", 
                "youtubeid": "CongressmanTedPoe"
            }, 
            "person_role": {
                "caucus": null, 
                "congress_numbers": [
                    114
                ], 
                "current": true, 
                "description": "Representative for Texas's 2nd congressional district", 
                "district": 2, 
                "enddate": "2017-01-03", 
                "extra": {
                    "address": "2412 Rayburn HOB; Washington DC 20515-4302", 
                    "contact_form": "https://poe.house.gov/index.cfm/contact-form#form_D05B44B5-B782-4DC7-BED6-FF0C90951FFF", 
                    "fax": "202-225-5547", 
                    "office": "2412 Rayburn House Office Building", 
                    "rss_url": "http://poe.house.gov/index.php?format=feed&amp;type=rss"
                }, 
                "id": 43428, 
                "leadership_title": null, 
                "party": "Republican", 
                "person": 400652, 
                "phone": "202-225-6565", 
                "role_type": "representative", 
                "role_type_label": "Representative", 
                "senator_class": null, 
                "senator_rank": null, 
                "startdate": "2015-01-06", 
                "state": "TX", 
                "title": "Rep.", 
                "title_long": "Representative", 
                "website": "https://poe.house.gov"
            }, 
            "vote": {
                "category": "passage_suspension", 
                "category_label": "Passage under Suspension", 
                "chamber": "house", 
                "chamber_label": "House", 
                "congress": 114, 
                "created": "2016-09-22T21:32:00", 
                "id": 118777, 
                "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
                "margin": 0.89372, 
                "missing_data": false, 
                "number": 556, 
                "percent_plus": 0.909513, 
                "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "question_details": "On Motion to Suspend the Rules and Pass in the House", 
                "related_amendment": null, 
                "related_bill": 346009, 
                "required": "2/3", 
                "result": "Passed", 
                "session": "2016", 
                "source": "house", 
                "source_label": "house.gov", 
                "total_minus": 22, 
                "total_other": 17, 
                "total_plus": 392, 
                "vote_type": "On Motion to Suspend the Rules and Pass"
            }, 
            "voter_type": "member", 
            "voter_type_label": "Member of Congress", 
            "voteview_extra_code": ""
        }, 
        {
            "created": "2016-09-22T21:32:00", 
            "id": 31459570, 
            "option": {
                "id": 458004, 
                "key": "0", 
                "value": "Not Voting", 
                "vote": 118777
            }, 
            "person": {
                "bioguideid": "P000197", 
                "birthday": "1940-03-26", 
                "cspanid": 6153, 
                "firstname": "Nancy", 
                "gender": "female", 
                "gender_label": "Female", 
                "id": 400314, 
                "lastname": "Pelosi", 
                "link": "https://www.govtrack.us/congress/members/nancy_pelosi/400314", 
                "middlename": "", 
                "name": "Rep. Nancy Pelosi [D-CA12]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00007360", 
                "pvsid": "26732", 
                "sortname": "Pelosi, Nancy (Rep.) [D-CA12]", 
                "twitterid": "NancyPelosi", 
                "youtubeid": "nancypelosi"
            }, 
            "person_role": {
                "caucus": null, 
                "congress_numbers": [
                    114
                ], 
                "current": true, 
                "description": "Representative for California's 12th congressional district", 
                "district": 12, 
                "enddate": "2017-01-03", 
                "extra": {
                    "address": "233 Cannon HOB; Washington DC 20515-0512", 
                    "contact_form": "http://pelosi.house.gov/contact-me/email-me", 
                    "fax": "202-225-8259", 
                    "office": "233 Cannon House Office Building", 
                    "rss_url": "http://pelosi.house.gov/atom.xml"
                }, 
                "id": 43364, 
                "leadership_title": "Minority Leader", 
                "party": "Democrat", 
                "person": 400314, 
                "phone": "202-225-4965", 
                "role_type": "representative", 
                "role_type_label": "Representative", 
                "senator_class": null, 
                "senator_rank": null, 
                "startdate": "2015-01-06", 
                "state": "CA", 
                "title": "Rep.", 
                "title_long": "Representative", 
                "website": "http://pelosi.house.gov"
            }, 
            "vote": {
                "category": "passage_suspension", 
                "category_label": "Passage under Suspension", 
                "chamber": "house", 
                "chamber_label": "House", 
                "congress": 114, 
                "created": "2016-09-22T21:32:00", 
                "id": 118777, 
                "link": "https://www.govtrack.us/congress/votes/114-2016/h556", 
                "margin": 0.89372, 
                "missing_data": false, 
                "number": 556, 
                "percent_plus": 0.909513, 
                "question": "H.R. 5798: To designate the facility of the United States Postal Service located at 1101 Davis Street in Evanston, Illinois, as the “Abner J. Mikva Post Office Building”.", 
                "question_details": "On Motion to Suspend the Rules and Pass in the House", 
                "related_amendment": null, 
                "related_bill": 346009, 
                "required": "2/3", 
                "result": "Passed", 
                "session": "2016", 
                "source": "house", 
                "source_label": "house.gov", 
                "total_minus": 22, 
                "total_other": 17, 
                "total_plus": 392, 
                "vote_type": "On Motion to Suspend the Rules and Pass"
            }, 
            "voter_type": "member", 
            "voter_type_label": "Member of Congress", 
            "voteview_extra_code": ""
        }
    ]
}

Fields

created
The date (and in recent history also time) on which the vote was held.
Filterable with operators. Sortable.
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
option
How the person voted. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object.
person
The person who cast this vote. May be null if the information could not be determined. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object. To search for a null value, filter on the special string 'null'.
person_role
The role of the person who cast this vote at the time of the vote. May be null if the information could not be determined. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object. To search for a null value, filter on the special string 'null'.
vote
The vote that this record is a part of. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object.
voter_type
Whether the voter was a Member of Congress or the Vice President.
This field can take on the following values:
Value Notes
vice_president Vice President
unknown Unknown
member Member of Congress
voteview_extra_code
Extra information provided in the voteview data.

Committee

Committees and subcommittees in the United States Congress, including historical committees.

Use the list API at https://www.govtrack.us/api/v2/committee to get a list of objects of this type. Add a slash and the ID of any object to get just that object. For instance, try out https://www.govtrack.us/api/v2/committee/2650.

{
    "abbrev": "Judiciary", 
    "code": "SSJU", 
    "committee": null, 
    "committee_type": "senate", 
    "committee_type_label": "Senate", 
    "id": 2650, 
    "jurisdiction": null, 
    "jurisdiction_link": null, 
    "name": "Senate Committee on the Judiciary", 
    "obsolete": false, 
    "url": "http://judiciary.senate.gov/"
}

Fields

abbrev
A really short abbreviation for the committee. Has no special significance.
code
An alphanumeric code used for the committee on THOMAS.gov, House.gov, and Senate.gov.
Filterable with operators. Sortable.
committee
This field indicates whether the object is a commmittee, in which case the committee field is null, or a subcommittee, in which case this field gives the parent committee. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object. To search for a null value, filter on the special string 'null'.
committee_type
Whether this is a House, Senate, or Joint committee.
This field can take on the following values:
Value Notes
senate Senate
joint Joint
house House
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
jurisdiction
The committee's jurisdiction, if known.
jurisdiction_link
A link to where the jurisdiction text was sourced from.
name
The name of the committee or subcommittee. Committee names typically look like '{House,Senate} Committee on ...', while subcommmittee names look like 'Legislative Branch'.
obsolete
True if this committee no longer exists.
Filterable with operators. Sortable.
url
The committee's website.

Committee_member

A record indicating the current membership of a Member of Congress on a committee or subcommittee. The IDs on these records are not stable (do not use them).

Use the list API at https://www.govtrack.us/api/v2/committee_member to get a list of objects of this type.

{
    "meta": {
        "limit": 5, 
        "offset": 0, 
        "total_count": 3772
    }, 
    "objects": [
        {
            "committee": {
                "abbrev": "", 
                "code": "HSVR09", 
                "committee": 2774, 
                "committee_type": null, 
                "id": 2775, 
                "jurisdiction": null, 
                "jurisdiction_link": null, 
                "name": "Disability Assistance and Memorial Affairs", 
                "obsolete": false, 
                "url": null
            }, 
            "id": 207975, 
            "person": {
                "bioguideid": "A000374", 
                "birthday": "1954-09-16", 
                "cspanid": null, 
                "firstname": "Ralph", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412630, 
                "lastname": "Abraham", 
                "link": "https://www.govtrack.us/congress/members/ralph_abraham/412630", 
                "middlename": "", 
                "name": "Rep. Ralph Abraham [R-LA5]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00036633", 
                "pvsid": null, 
                "sortname": "Abraham, Ralph (Rep.) [R-LA5]", 
                "twitterid": "RepAbraham", 
                "youtubeid": null
            }, 
            "role": "chairman", 
            "role_label": "Chairman"
        }, 
        {
            "committee": {
                "abbrev": "", 
                "code": "HSVR09", 
                "committee": 2774, 
                "committee_type": null, 
                "id": 2775, 
                "jurisdiction": null, 
                "jurisdiction_link": null, 
                "name": "Disability Assistance and Memorial Affairs", 
                "obsolete": false, 
                "url": null
            }, 
            "id": 207976, 
            "person": {
                "bioguideid": "L000564", 
                "birthday": "1954-05-24", 
                "cspanid": 1022846, 
                "firstname": "Doug", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412191, 
                "lastname": "Lamborn", 
                "link": "https://www.govtrack.us/congress/members/doug_lamborn/412191", 
                "middlename": "", 
                "name": "Rep. Doug Lamborn [R-CO5]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00028133", 
                "pvsid": "2698", 
                "sortname": "Lamborn, Doug (Rep.) [R-CO5]", 
                "twitterid": "RepDLamborn", 
                "youtubeid": "CongressmanLamborn"
            }, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": {
                "abbrev": "", 
                "code": "HSVR09", 
                "committee": 2774, 
                "committee_type": null, 
                "id": 2775, 
                "jurisdiction": null, 
                "jurisdiction_link": null, 
                "name": "Disability Assistance and Memorial Affairs", 
                "obsolete": false, 
                "url": null
            }, 
            "id": 207977, 
            "person": {
                "bioguideid": "Z000017", 
                "birthday": "1980-01-30", 
                "cspanid": null, 
                "firstname": "Lee", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412646, 
                "lastname": "Zeldin", 
                "link": "https://www.govtrack.us/congress/members/lee_zeldin/412646", 
                "middlename": "", 
                "name": "Rep. Lee Zeldin [R-NY1]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00029404", 
                "pvsid": null, 
                "sortname": "Zeldin, Lee (Rep.) [R-NY1]", 
                "twitterid": "RepLeeZeldin", 
                "youtubeid": null
            }, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": {
                "abbrev": "", 
                "code": "HSVR09", 
                "committee": 2774, 
                "committee_type": null, 
                "id": 2775, 
                "jurisdiction": null, 
                "jurisdiction_link": null, 
                "name": "Disability Assistance and Memorial Affairs", 
                "obsolete": false, 
                "url": null
            }, 
            "id": 207978, 
            "person": {
                "bioguideid": "C001106", 
                "birthday": "1976-09-07", 
                "cspanid": null, 
                "firstname": "Ryan", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412651, 
                "lastname": "Costello", 
                "link": "https://www.govtrack.us/congress/members/ryan_costello/412651", 
                "middlename": "", 
                "name": "Rep. Ryan Costello [R-PA6]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00031064", 
                "pvsid": null, 
                "sortname": "Costello, Ryan (Rep.) [R-PA6]", 
                "twitterid": "RepRyanCostello", 
                "youtubeid": null
            }, 
            "role": "member", 
            "role_label": "Member"
        }, 
        {
            "committee": {
                "abbrev": "", 
                "code": "HSVR09", 
                "committee": 2774, 
                "committee_type": null, 
                "id": 2775, 
                "jurisdiction": null, 
                "jurisdiction_link": null, 
                "name": "Disability Assistance and Memorial Affairs", 
                "obsolete": false, 
                "url": null
            }, 
            "id": 207979, 
            "person": {
                "bioguideid": "B001295", 
                "birthday": "1960-12-30", 
                "cspanid": null, 
                "firstname": "Mike", 
                "gender": "male", 
                "gender_label": "Male", 
                "id": 412629, 
                "lastname": "Bost", 
                "link": "https://www.govtrack.us/congress/members/mike_bost/412629", 
                "middlename": "", 
                "name": "Rep. Mike Bost [R-IL12]", 
                "namemod": "", 
                "nickname": "", 
                "osid": "N00035420", 
                "pvsid": null, 
                "sortname": "Bost, Mike (Rep.) [R-IL12]", 
                "twitterid": "RepBost", 
                "youtubeid": null
            }, 
            "role": "member", 
            "role_label": "Member"
        }
    ]
}

Fields

committee
The committee or subcommittee being served on. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object.
id
The primary key of this resource. Add a slash and this ID to the base URI for this API endpoint to get information on just this object.
Filterable with operators. Sortable.
person
The Member of Congress serving on a committee. The full object is included in the response as a JSON dict (or equivalent in other output formats).
Filterable with operators. Sortable. When filtering, specify the integer ID of the target object.
role
The role of the member on the committee.
This field can take on the following values:
Value Notes
member Member
ranking_member Ranking Member
vice_chairman Vice Chairman
exofficio Ex Officio
chairman Chairman