{"uid":"cap_I7TuFv8ZT8NkZ4dzsvwiN","slug":"2s-io-9ee6c74f","name":"2s.io US Senate Roll-Call Votes","description":"US Senate roll-call votes, newest first by vote date. Each record includes congress + session + vote_number, vote question + result + title + majority requirement, vote date/time, document name (e.g., S. 5, H.R. 4499), document title, grand totals (yeas/nays/present/absent), AND per-party breakdown (D/R/I yea/nay/present/absent counts derived from member-level vote_cast). Filters (all optional, AND-combined): congress, session (1 or 2), result substring, document substring (e.g., 'S. 5'), since/until (vote_date), limit + offset. Locally aggregated from senate.gov XML feeds (refreshed daily). Public-domain US government records.","url":"https://2s.io/api/gov/senate-votes","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Max records (1-100). Default 25."},"since":{"type":"string","description":"Earliest vote date (YYYY-MM-DD)."},"until":{"type":"string","description":"Latest vote date (YYYY-MM-DD)."},"offset":{"type":"integer","default":0,"maximum":100000,"minimum":0,"description":"Offset for pagination. Default 0."},"result":{"type":"string","maxLength":60,"minLength":2,"description":"Filter by vote result (case-insensitive substring). Examples: \"Agreed\", \"Rejected\", \"Cloture\"."},"session":{"type":"integer","description":"Filter by session (1 = odd year, 2 = even year of a Congress)."},"congress":{"type":"integer","maximum":200,"minimum":100,"description":"Filter by Congress number. The 119th Congress = 2025-2026."},"document":{"type":"string","maxLength":40,"minLength":2,"description":"Filter by document name substring (case-insensitive on document_name). Examples: \"S. 5\", \"H.R. 4499\", \"H.R.\"."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":10,"session":1,"congress":119}}},"response":{"data":{"query":{"limit":10,"since":null,"until":null,"offset":0,"result":null,"session":1,"congress":119,"document":null},"votes":[{"totals":{"nays":45,"yeas":53,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-30","voteTime":"01:54 PM","voteTitle":"Confirmation: Thomas Gaiser, of Ohio, to be an Assistant Attorney General","voteNumber":450,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN129-4","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00450.xml","voteQuestion":"On the Nomination PN129-4","documentTitle":"Thomas Gaiser, of Ohio, to be an Assistant Attorney General","totalsByParty":{"D":{"nay":43,"yea":0,"absent":2,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":53,"absent":0,"present":0}},"voteResultText":"Nomination Confirmed (53-45)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":53,"absent":0,"present":0},"session":1,"congress":119,"voteDate":"2025-07-30","voteTime":"11:31 AM","voteTitle":"Motion to Invoke Cloture: Thomas Gaiser to be an Assistant Attorney General","voteNumber":449,"voteResult":"Cloture Motion Agreed to","congressYear":2025,"documentName":"PN129-4","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00449.xml","voteQuestion":"On the Cloture Motion PN129-4","documentTitle":"Thomas Gaiser, of Ohio, to be an Assistant Attorney General","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":53,"absent":0,"present":0}},"voteResultText":"Cloture Motion Agreed to (53-47)","majorityRequirement":"1/2"},{"totals":{"nays":49,"yeas":50,"absent":1,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"08:39 PM","voteTitle":"Confirmation: Emil Bove III, of Pennsylvania, to be United States Circuit Judge for the Third Circuit","voteNumber":448,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN346-2","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00448.xml","voteQuestion":"On the Nomination PN346-2","documentTitle":"Emil J. Bove III, of Pennsylvania, to be United States Circuit Judge for the Third Circuit","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":2,"yea":50,"absent":1,"present":0}},"voteResultText":"Nomination Confirmed (50-49)","majorityRequirement":"1/2"},{"totals":{"nays":44,"yeas":54,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"08:02 PM","voteTitle":"Confirmation: Samuel Brown, of Nevada, to be Under Secretary of Veterans Affairs for Memorial Services","voteNumber":447,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN12-7","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00447.xml","voteQuestion":"On the Nomination PN12-7","documentTitle":"Samuel Brown, of Nevada, to be Under Secretary of Veterans Affairs for Memorial Affairs","totalsByParty":{"D":{"nay":42,"yea":2,"absent":1,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":52,"absent":1,"present":0}},"voteResultText":"Nomination Confirmed (54-44)","majorityRequirement":"1/2"},{"totals":{"nays":45,"yeas":53,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"06:21 PM","voteTitle":"Motion to Invoke Cloture: Samuel Brown to be Under Secretary of Veterans Affairs for Memorial Affairs","voteNumber":446,"voteResult":"Cloture Motion Agreed to","congressYear":2025,"documentName":"PN12-7","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00446.xml","voteQuestion":"On the Cloture Motion PN12-7","documentTitle":"Samuel Brown, of Nevada, to be Under Secretary of Veterans Affairs for Memorial Affairs","totalsByParty":{"D":{"nay":43,"yea":2,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":51,"absent":2,"present":0}},"voteResultText":"Cloture Motion Agreed to (53-45)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":51,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"05:41 PM","voteTitle":"Confirmation: Susan Monarez, of Wisconsin, to be Director of the Centers for Disease Control and Prevention","voteNumber":445,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN60-14","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00445.xml","voteQuestion":"On the Nomination PN60-14","documentTitle":"Susan Monarez, of Wisconsin, to be Director of the Centers for Disease Control and Prevention","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":51,"absent":2,"present":0}},"voteResultText":"Nomination Confirmed (51-47)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":52,"absent":1,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"02:48 PM","voteTitle":"Motion to Invoke Cloture: Susan Monarez to be Director of the Centers for Disease Control and Prevention","voteNumber":444,"voteResult":"Cloture Motion Agreed to","congressYear":2025,"documentName":"PN60-14","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00444.xml","voteQuestion":"On the Cloture Motion PN60-14","documentTitle":"Susan Monarez, of Wisconsin, to be Director of the Centers for Disease Control and Prevention","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":52,"absent":1,"present":0}},"voteResultText":"Cloture Motion Agreed to (52-47)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":51,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"02:15 PM","voteTitle":"Confirmation: William Kimmitt, of Virginia, to be Under Secretary of Commerce for International Trade","voteNumber":443,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN22-13","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00443.xml","voteQuestion":"On the Nomination PN22-13","documentTitle":"William Kimmitt, of Virginia, to be Under Secretary of Commerce for International Trade","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":51,"absent":2,"present":0}},"voteResultText":"Nomination Confirmed (51-47)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":51,"absent":2,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"12:13 PM","voteTitle":"Motion to Invoke Cloture: William Kimmitt to be Under Secretary of Commerce for International Trade","voteNumber":442,"voteResult":"Cloture Motion Agreed to","congressYear":2025,"documentName":"PN22-13","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00442.xml","voteQuestion":"On the Cloture Motion PN22-13","documentTitle":"William Kimmitt, of Virginia, to be Under Secretary of Commerce for International Trade","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":51,"absent":2,"present":0}},"voteResultText":"Cloture Motion Agreed to (51-47)","majorityRequirement":"1/2"},{"totals":{"nays":47,"yeas":50,"absent":3,"present":0},"session":1,"congress":119,"voteDate":"2025-07-29","voteTime":"11:30 AM","voteTitle":"Confirmation: Earl Matthews, of Virginia, to be General Counsel of the Department of Defense","voteNumber":441,"voteResult":"Nomination Confirmed","congressYear":2025,"documentName":"PN22-17","sourceXmlUrl":"https://www.senate.gov/legislative/LIS/roll_call_votes/vote1191/vote_119_1_00441.xml","voteQuestion":"On the Nomination PN22-17","documentTitle":"Earl Matthews, of Virginia, to be General Counsel of the Department of Defense","totalsByParty":{"D":{"nay":45,"yea":0,"absent":0,"present":0},"I":{"nay":2,"yea":0,"absent":0,"present":0},"R":{"nay":0,"yea":50,"absent":3,"present":0}},"voteResultText":"Nomination Confirmed (50-47)","majorityRequirement":"1/2"}],"source":{"url":"https://www.senate.gov/legislative/votes_new.htm","license":"Public domain (US government records)","provider":"US Senate — Roll-call votes"},"returned":10,"pagination":{"nextOffset":10,"previousOffset":null},"totalCount":450},"meta":{"cost":{"usd":0.0024,"tier":0},"caller":"x402","version":null,"endpoint":"gov.senate-votes","settlement":{"txHash":"0xf458df53d33aaf497471a446b235bb201cab819949b8793f29c807d4718135ad","network":"eip155:8453","success":true}}}},"exampleRequest":{"limit":10,"session":1,"congress":119},"tags":["x402"],"displayCostAmount":"0.0024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2LPL45LO7tNukg_3-NIiR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns US Senate roll-call votes with vote totals and per-party breakdowns, filtered by congress, session, date range, result, or document name.","exampleAgentPrompt":"Can you pull up all US Senate roll-call votes on H.R. 4499 from the 119th Congress and show me the yea/nay totals broken down by party?","exampleUseCases":null,"resultDescription":"A paginated list of Senate roll-call votes, each including congress+session+vote_number, the vote question, result, title, majority requirement, vote date/time, document name and title, grand totals (yeas/nays/present/absent), and per-party (Democrat/Republican/Independent) breakdowns of yea/nay/present/absent counts.","failureModes":["No records match the given filters — returns empty list","Invalid date format for since/until — rejected by schema validation","congress value out of range (must be 100–200) — schema validation error","limit exceeds 100 — schema validation error","Payment not included or rejected — 402 response requiring x402 payment","document substring too short (min 2 chars) — schema validation error"],"whenToPreferThis":"Use this endpoint when you need structured, filterable US Senate roll-call vote data with per-party breakdowns — especially when you need to filter by specific Congress, session, date range, bill name, or vote result. Prefer this over scraping senate.gov directly since it provides pre-aggregated party-level tallies refreshed daily from official XML feeds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:50:58.646Z","isFirstParty":false}