{"openapi":"3.1.0","info":{"title":"US Congress API","version":"1.0.0","description":"Every member of the United States Congress as an API — all 12,766 legislators, current and historical, from 1789 to today. Look up any member by Bioguide or GovTrack id, or search and filter the full roster by name, US state, party and chamber (Senate / House), and list the current members of Congress. Each record carries the member's name, gender, birthday, party, state and district, chamber, the number of terms served and the complete term-by-term history with start and end dates, plus cross-reference ids (GovTrack, OpenSecrets, FEC, Wikipedia, Wikidata). Ideal for civic-tech, news, government-transparency, lobbying and political-research apps. Data from the public-domain @unitedstates project.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/congress-api","description":"oanor gateway"}],"tags":[{"name":"Congress"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/current":{"get":{"operationId":"get_v1_current","tags":["Congress"],"summary":"Current members of Congress","description":"","parameters":[{"name":"chamber","in":"query","required":false,"description":"senate | house","schema":{"type":"string"},"example":"senate"},{"name":"state","in":"query","required":false,"description":"US state, 2-letter","schema":{"type":"string"}},{"name":"party","in":"query","required":false,"description":"Party filter","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-600, default 50)","schema":{"type":"string"},"example":"50"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"limit":50,"total":100,"offset":0,"filters":{"chamber":"senate"},"results":[{"name":"Maria Cantwell","party":"Democrat","state":"WA","chamber":"senate","current":true,"bioguide":"C000127","govtrack":300018,"served_to":"2031-01-03","term_count":6,"served_from":"1993-01-05"},{"name":"Amy Klobuchar","party":"Democrat","state":"MN","chamber":"senate","current":true,"bioguide":"K000367","govtrack":412242,"served_to":"2031-01-03","term_count":4,"served_from":"2007-01-04"},{"name":"Bernard Sanders","party":"Independent","state":"VT","chamber":"senate","current":true,"bioguide":"S000033","govtrack":400357,"served_to":"2031-01-03","term_count":12,"served_from":"1991-01-03"},{"name":"Sheldon Whitehouse","party":"Democrat","state":"RI","chamber":"senate","current":true,"bioguide":"W000802","govtrack":412247,"served_to":"2031-01-03","term_count":4,"served_from":"2007-01-04"},{"name":"John Barrasso","party":"Republican","state":"WY","chamber":"senate","current":true,"bioguide":"B001261","govtrack":412251,"served_to":"2031-01-03","term_count":4,"served_from":"2007-06-25"},{"name":"Roger F. Wicker","party":"Republican","state":"MS","chamber":"senate","current":true,"bioguide":"W000437","govtrack":400432,"served_to":"2031-01-03","term_count":11,"served_from":"1995-01-04"},{"name":"Susan M. Collins","party":"Republican","state":"ME","chamber":"senate","current":true,"bioguide":"C001035","govtrack":300025,"served_to":"2027-01-03","term_count":5,"served_from":"1997-01-07"},{"name":"John Cornyn","party":"Republican","state":"TX","chamber":"senate","current":true,"bioguide":"C001056","govtrack":300027,"served_to":"2027-01-03","term_count":5,"served_from":"2002-11-30"},{"name":"Richard J. Durbin","party":"Democrat","state":"IL","chamber":"senate","current":true,"bioguide":"D000563","govtrack":300038,"served_to":"2027-01-03","term_count":12,"served_from":"1983-01-03"},{"name":"Lindsey Graham","party":"Republican","state":"SC","chamber":"senate","current":true,"bioguide":"G000359","govtrack":300047,"served_to":"2027-01-03","term_count":8,"served_from":"1995-01-04"},{"name":"Mitch McConnell","party":"Republican","state":"KY","chamber":"senate","current":true,"bioguide":"M000355","govtrack":300072,"served_to":"2027-01-03","term_count":7,"served_from":"1985-01-03"},{"name":"Jeff Merkley","party":"Democrat","state":"OR","chamber":"senate","current":true,"bioguide":"M001176","govtrack":412325,"served_to":"2027-01-03","term_count":3,"served_from":"2009-01-06"},{"name":"Jack Reed","party":"Democrat","state":"RI","chamber":"senate","current":true,"bioguide":"R000122","govtrack":300081,"served_to":"2027-01-03","term_count":8,"served_from":"1991-01-03"},{"name":"James E. Risch","party":"Republican","state":"ID","chamber":"senate","current":true,"bioguide":"R000584","govtrack":412322,"served_to":"2027-01-03","term_count":3,"served_from":"2009-01-06"},{"name":"Jeanne Shaheen","party":"Democrat","state":"NH","chamber":"senate","current":true,"bioguide":"S001181","govtrack":412323,"served_to":"2027-01-03","term_count":3,"served_from":"2009-01-06"},{"name":"Mark R. Warner","party":"Democrat","state":"VA","chamber":"senate","current":true,"bioguide":"W000805","govtrack":412321,"served_to":"2027-01-03","term_count":3,"served_from":"2009-01-06"},{"name":"Kirsten E. Gillibrand","party":"Democrat","state":"NY","chamber":"senate","current":true,"bioguide":"G000555","govtrack":412223,"served_to":"2031-01-03","term_count":6,"served_from":"2007-01-04"},{"name":"Christopher A. Coons","party":"Democrat","state":"DE","chamber":"senate","current":true,"bioguide":"C001088","govtrack":412390,"served_to":"2027-01-03","term_count":3,"served_from":"2010-11-15"},{"name":"Tammy Baldwin","party":"Democrat","state":"WI","chamber":"senate","current":true,"bioguide":"B001230","govtrack":400013,"served_to":"2031-01-03","term_count":10,"served_from":"1999-01-06"},{"name":"Michael F. Bennet","party":"Democrat","state":"CO","chamber":"senate","current":true,"bioguide":"B001267","govtrack":412330,"served_to":"2029-01-03","term_count":4,"served_from":"2009-01-22"},{"name":"Marsha Blackburn","party":"Republican","state":"TN","chamber":"senate","current":true,"bioguide":"B001243","govtrack":400032,"served_to":"2031-01-03","term_count":10,"served_from":"2003-01-07"},{"name":"Richard Blumenthal","party":"Democrat","state":"CT","chamber":"senate","current":true,"bioguide":"B001277","govtrack":412490,"served_to":"2029-01-03","term_count":3,"served_from":"2011-01-05"},{"name":"John Boozman","party":"Republican","state":"AR","chamber":"senate","current":true,"bioguide":"B001236","govtrack":400040,"served_to":"2029-01-03","term_count":8,"served_from":"2001-11-29"},{"name":"Shelley Moore Capito","party":"Republican","state":"WV","chamber":"senate","current":true,"bioguide":"C001047","govtrack":400061,"served_to":"2027-01-03","term_count":9,"served_from":"2001-01-03"},{"name":"Bill Cassidy","party":"Republican","state":"LA","chamber":"senate","current":true,"bioguide":"C001075","govtrack":412269,"served_to":"2027-01-03","term_count":5,"served_from":"2009-01-06"},{"name":"Mike Crapo","party":"Republican","state":"ID","chamber":"senate","current":true,"bioguide":"C000880","govtrack":300030,"served_to":"2029-01-03","term_count":8,"served_from":"1993-01-05"},{"name":"Chuck Grassley","party":"Republican","state":"IA","chamber":"senate","current":true,"bioguide":"G000386","govtrack":300048,"served_to":"2029-01-03","term_count":11,"served_from":"1975-01-14"},{"name":"Martin Heinrich","party":"Democrat","state":"NM","chamber":"senate","current":true,"bioguide":"H001046","govtrack":412281,"served_to":"2031-01-03","term_count":5,"served_from":"2009-01-06"},{"name":"Mazie K. Hirono","party":"Democrat","state":"HI","chamber":"senate","current":true,"bioguide":"H001042","govtrack":412200,"served_to":"2031-01-03","term_count":6,"served_from":"2007-01-04"},{"name":"John Hoeven","party":"Republican","state":"ND","chamber":"senate","current":true,"bioguide":"H001061","govtrack":412494,"served_to":"2029-01-03","term_count":3,"served_from":"2011-01-05"},{"name":"Ron Johnson","party":"Republican","state":"WI","chamber":"senate","current":true,"bioguide":"J000293","govtrack":412496,"served_to":"2029-01-03","term_count":3,"served_from":"2011-01-05"},{"name":"James Lankford","party":"Republican","state":"OK","chamber":"senate","current":true,"bioguide":"L000575","govtrack":412464,"served_to":"2029-01-03","term_count":5,"served_from":"2011-01-05"},{"name":"Mike Lee","party":"Republican","state":"UT","chamber":"senate","current":true,"bioguide":"L000577","govtrack":412495,"served_to":"2029-01-03","term_count":3,"served_from":"2011-01-05"},{"name":"Ben Ray Luján","party":"Democrat","state":"NM","chamber":"senate","current":true,"bioguide":"L000570","govtrack":412293,"served_to":"2027-01-03","term_count":7,"served_from":"2009-01-06"},{"name":"Edward J. Markey","party":"Democrat","state":"MA","chamber":"senate","current":true,"bioguide":"M000133","govtrack":400253,"served_to":"2027-01-03","term_count":23,"served_from":"1975-01-14"},{"name":"Jerry Moran","party":"Republican","state":"KS","chamber":"senate","current":true,"bioguide":"M000934","govtrack":400284,"served_to":"2029-01-03","term_count":10,"served_from":"1997-01-07"},{"name":"Lisa Murkowski","party":"Republican","state":"AK","chamber":"senate","current":true,"bioguide":"M001153","govtrack":300075,"served_to":"2029-01-03","term_count":5,"served_from":"2003-01-07"},{"name":"Christopher Murphy","party":"Democrat","state":"CT","chamber":"senate","current":true,"bioguide":"M001169","govtrack":412194,"served_to":"2031-01-03","term_count":6,"served_from":"2007-01-04"},{"name":"Patty Murray","party":"Democrat","state":"WA","chamber":"senate","current":true,"bioguide":"M001111","govtrack":300076,"served_to":"2029-01-03","term_count":6,"served_from":"1993-01-05"},{"name":"Rand Paul","party":"Republican","state":"KY","chamber":"senate","current":true,"bioguide":"P000603","govtrack":412492,"served_to":"2029-01-03","term_count":3,"served_from":"2011-01-05"},{"name":"Gary C. Peters","party":"Democrat","state":"MI","chamber":"senate","current":true,"bioguide":"P000595","govtrack":412305,"served_to":"2027-01-03","term_count":5,"served_from":"2009-01-06"},{"name":"Adam B. Schiff","party":"Democrat","state":"CA","chamber":"senate","current":true,"bioguide":"S001150","govtrack":400361,"served_to":"2031-01-03","term_count":14,"served_from":"2001-01-03"},{"name":"Charles E. Schumer","party":"Democrat","state":"NY","chamber":"senate","current":true,"bioguide":"S000148","govtrack":300087,"served_to":"2029-01-03","term_count":14,"served_from":"1981-01-05"},{"name":"Tim Scott","party":"Republican","state":"SC","chamber":"senate","current":true,"bioguide":"S001184","govtrack":412471,"served_to":"2029-01-03","term_count":5,"served_from":"2011-01-05"},{"name":"John Thune","party":"Republican","state":"SD","chamber":"senate","current":true,"bioguide":"T000250","govtrack":400546,"served_to":"2029-01-03","term_count":7,"served_from":"1997-01-07"},{"name":"Chris Van Hollen","party":"Democrat","state":"MD","chamber":"senate","current":true,"bioguide":"V000128","govtrack":400415,"served_to":"2029-01-03","term_count":9,"served_from":"2003-01-07"},{"name":"Peter Welch","party":"Democrat","state":"VT","chamber":"senate","current":true,"bioguide":"W000800","govtrack":412239,"served_to":"2029-01-03","term_count":9,"served_from":"2007-01-04"},{"name":"Ron Wyden","party":"Democrat","state":"OR","chamber":"senate","current":true,"bioguide":"W000779","govtrack":300100,"served_to":"2029-01-03","term_count":14,"served_from":"1981-01-05"},{"name":"Todd Young","party":"Republican","state":"IN","chamber":"senate","current":true,"bioguide":"Y000064","govtrack":412428,"served_to":"2029-01-03","term_count":5,"served_from":"2011-01-05"},{"name":"Brian Schatz","party":"Democrat","state":"HI","chamber":"senate","current":true,"bioguide":"S001194","govtrack":412507,"served_to":"2029-01-03","term_count":4,"served_from":"2012-12-27"}]},"meta":{"timestamp":"2026-05-31T07:41:40.067Z","request_id":"638efc4d-2c2f-4e69-a941-919033e4be44"},"status":"ok","message":"Current members retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/legislator":{"get":{"operationId":"get_v1_legislator","tags":["Congress"],"summary":"One legislator by id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Bioguide id, e.g. C000127 (Maria Cantwell)","schema":{"type":"string"},"example":"C000127"},{"name":"govtrack","in":"query","required":false,"description":"GovTrack id (alternative to id)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"legislator":{"last":"Cantwell","name":"Maria Cantwell","first":"Maria","party":"Democrat","state":"WA","terms":[{"end":"1995-01-03","type":"rep","party":"Democrat","start":"1993-01-05","state":"WA","district":1},{"end":"2007-01-03","type":"sen","party":"Democrat","start":"2001-01-03","state":"WA"},{"end":"2013-01-03","type":"sen","party":"Democrat","start":"2007-01-04","state":"WA"},{"end":"2019-01-03","type":"sen","party":"Democrat","start":"2013-01-03","state":"WA"},{"end":"2025-01-03","type":"sen","party":"Democrat","start":"2019-01-03","state":"WA"},{"end":"2031-01-03","type":"sen","party":"Democrat","start":"2025-01-03","state":"WA"}],"gender":"F","chamber":"senate","current":true,"parties":["Democrat"],"bioguide":"C000127","birthday":"1958-10-13","govtrack":300018,"wikidata":"Q22250","served_to":"2031-01-03","wikipedia":"Maria Cantwell","term_count":6,"served_from":"1993-01-05"}},"meta":{"timestamp":"2026-05-31T07:41:40.139Z","request_id":"b3d7a9c3-95f1-45bf-b730-5c84bcdd9e19"},"status":"ok","message":"Legislator retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Congress"],"summary":"Search current + historical legislators","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Name search (matched against full name)","schema":{"type":"string"},"example":"smith"},{"name":"state","in":"query","required":false,"description":"US state, 2-letter, e.g. CA","schema":{"type":"string"}},{"name":"party","in":"query","required":false,"description":"Party, e.g. Democrat, Republican","schema":{"type":"string"}},{"name":"chamber","in":"query","required":false,"description":"senate | house","schema":{"type":"string"}},{"name":"current","in":"query","required":false,"description":"true = only current members","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":144,"offset":0,"filters":{"name":"smith"},"results":[{"name":"Adam Smith","party":"Democrat","state":"WA","chamber":"house","current":true,"bioguide":"S000510","district":9,"govtrack":400379,"served_to":"2027-01-03","term_count":15,"served_from":"1997-01-07"},{"name":"Adrian Smith","party":"Republican","state":"NE","chamber":"house","current":true,"bioguide":"S001172","district":3,"govtrack":412217,"served_to":"2027-01-03","term_count":10,"served_from":"2007-01-04"},{"name":"Christopher H. Smith","party":"Republican","state":"NJ","chamber":"house","current":true,"bioguide":"S000522","district":4,"govtrack":400380,"served_to":"2027-01-03","term_count":23,"served_from":"1981-01-05"},{"name":"Jason Smith","party":"Republican","state":"MO","chamber":"house","current":true,"bioguide":"S001195","district":8,"govtrack":412596,"served_to":"2027-01-03","term_count":7,"served_from":"2013-06-04"},{"name":"Tina Smith","party":"Democrat","state":"MN","chamber":"senate","current":true,"bioguide":"S001203","govtrack":412742,"served_to":"2027-01-03","term_count":3,"served_from":"2018-01-03"},{"name":"William Smith","state":"MD","chamber":"house","current":false,"bioguide":"S000624","district":4,"govtrack":410099,"served_to":"1791-03-03","term_count":1,"served_from":"1789-03-04"},{"name":"Isaac Smith","party":"Federalist","state":"NJ","chamber":"house","current":false,"bioguide":"S000555","district":-1,"govtrack":410037,"served_to":"1797-03-03","term_count":1,"served_from":"1795-12-07"},{"name":"Jeremiah Smith","party":"Federalist","state":"NH","chamber":"house","current":false,"bioguide":"S000563","district":-1,"govtrack":410045,"served_to":"1799-03-03","term_count":4,"served_from":"1791-10-24"},{"name":"Nathaniel Smith","party":"Federalist","state":"CT","chamber":"house","current":false,"bioguide":"S000595","district":-1,"govtrack":410075,"served_to":"1799-03-03","term_count":2,"served_from":"1795-12-07"},{"name":"William Smith","party":"Republican","state":"SC","chamber":"house","current":false,"bioguide":"S000625","district":6,"govtrack":410100,"served_to":"1799-03-03","term_count":1,"served_from":"1797-05-15"},{"name":"William Smith","party":"Federalist","state":"SC","chamber":"house","current":false,"bioguide":"S000633","district":1,"govtrack":410107,"served_to":"1799-03-03","term_count":5,"served_from":"1789-03-04"},{"name":"Josiah Smith","party":"Republican","state":"MA","chamber":"house","current":false,"bioguide":"S000582","district":6,"govtrack":410063,"served_to":"1803-03-03","term_count":1,"served_from":"1801-12-07"},{"name":"Israel Smith","party":"Republican","state":"VT","chamber":"senate","current":false,"bioguide":"S000557","govtrack":410039,"served_to":"1807-12-31","term_count":5,"served_from":"1791-10-24"},{"name":"John Smith","party":"Republican","state":"OH","chamber":"senate","current":false,"bioguide":"S000567","govtrack":410048,"served_to":"1809-03-03","term_count":1,"served_from":"1803-10-17"},{"name":"Daniel Smith","party":"Republican","state":"TN","chamber":"senate","current":false,"bioguide":"S000524","govtrack":410007,"served_to":"1809-12-31","term_count":2,"served_from":"1798-01-01"},{"name":"John Smith","party":"Federalist","state":"CT","chamber":"house","current":false,"bioguide":"S000570","district":-1,"govtrack":410052,"served_to":"1807-03-03","term_count":4,"served_from":"1799-12-02"},{"name":"O’Brien Smith","party":"Republican","state":"SC","chamber":"house","current":false,"bioguide":"S000598","district":4,"govtrack":412179,"served_to":"1807-03-03","term_count":1,"served_from":"1805-12-02"},{"name":"Jedediah Smith","party":"Republican","state":"NH","chamber":"house","current":false,"bioguide":"S000562","district":-1,"govtrack":410044,"served_to":"1809-03-03","term_count":1,"served_from":"1807-10-26"},{"name":"John Smith","party":"Republican","state":"NY","chamber":"senate","current":false,"bioguide":"S000566","govtrack":410046,"served_to":"1813-03-03","term_count":4,"served_from":"1799-12-02"},{"name":"Samuel Smith","party":"Republican","state":"PA","chamber":"house","current":false,"bioguide":"S000610","district":11,"govtrack":412102,"served_to":"1811-03-03","term_count":3,"served_from":"1805-12-02"}]},"meta":{"timestamp":"2026-05-31T07:41:40.216Z","request_id":"3c679ed2-7d18-44ed-b883-3b5d8879f918"},"status":"ok","message":"Legislators searched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & breakdown","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Every member of the US Congress, current and historical (1789-present). chamber: senate | house. Look up by bioguide id, search/filter by name/state/party/chamber, or list current members.","total":12766,"fields":["bioguide","govtrack","wikidata","name","gender","birthday","current","chamber","state","district","party","term_count","terms"],"source":"@unitedstates/congress-legislators","states":59,"current":536,"current_house":436,"current_senate":100,"current_by_party":{"Democrat":260,"Republican":273,"Independent":3}},"meta":{"timestamp":"2026-05-31T07:41:40.267Z","request_id":"04d30351-ea52-42c0-b9c3-76eb05083bb3"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3800,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":580,"monthly_call_quota":53000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1550,"monthly_call_quota":270000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3900,"monthly_call_quota":1280000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/congress-api"}