{"uid":"cap_2gTScswVEi_O45a55NN4a","slug":"2s-io-74620c2d","name":"US House of Representatives Roll-Call Votes API","description":"US House of Representatives roll-call votes, newest first by action date. Each record includes year + roll number, congress/session, vote question + type + result, action date/time, bill reference (legis_num), description, grand totals (yea/nay/present/not-voting), AND per-party breakdown (Republican/Democratic/Independent yea/nay/present/not-voting counts). Filters (all optional, AND-combined): year, congress, result substring, bill substring (legis_num ILIKE), since/until (action_date), limit + offset. Locally aggregated from clerk.house.gov XML feeds (refreshed daily by cron). Public-domain US government records.","url":"https://2s.io/api/gov/house-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":{"bill":{"type":"string","maxLength":40,"minLength":2,"description":"Filter by bill reference (case-insensitive substring on legis_num). Examples: \"H R 498\", \"H R 49\", \"S 1\"."},"year":{"type":"integer","maximum":2099,"minimum":1990,"description":"Filter by year. Example: 2025."},"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Max records (1-100). Default 25."},"since":{"type":"string","description":"Earliest action date (YYYY-MM-DD)."},"until":{"type":"string","description":"Latest action date (YYYY-MM-DD)."},"offset":{"type":"integer","default":0,"maximum":100000,"minimum":0,"description":"Offset for pagination. Default 0."},"result":{"type":"string","maxLength":40,"minLength":2,"description":"Filter by vote result (case-insensitive substring). Examples: \"Passed\", \"Failed\", \"Agreed\"."},"congress":{"type":"integer","maximum":200,"minimum":100,"description":"Filter by Congress number. The 119th Congress = 2025-2026."}},"additionalProperties":false}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"year":2025,"limit":25,"offset":0,"result":"Passed","congress":119}}},"response":{"_truncated":true,"_originalSize":16490}},"exampleRequest":{"year":2025,"limit":25,"offset":0,"result":"Passed","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_7A1AZ_YBgywAht929ScNx","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 paginated US House roll-call vote records with grand totals and per-party breakdowns, filtered by year, congress, bill, result, or date range","exampleAgentPrompt":"Can you pull the most recent House roll-call votes from the 119th Congress in 2025 that resulted in 'Passed', and show me the Republican and Democratic breakdown for each one? Give me the latest 25.","exampleUseCases":null,"resultDescription":"A paginated list of House roll-call vote records, each including the roll number, congress and session, vote question, vote type, vote result, action date and time, bill reference (legis_num), description, grand totals (yea/nay/present/not-voting), and per-party counts for Republican, Democratic, and Independent members.","failureModes":["Invalid date format for since/until returns a validation error","Bill substring too short (under 2 chars) returns a schema validation error","Year out of range (before 1990 or after 2099) returns a validation error","Congress number out of range returns a validation error","Offset beyond available records returns an empty result set","Payment not included or insufficient returns HTTP 402"],"whenToPreferThis":"Use this endpoint when you need structured, filterable US House roll-call vote data with per-party breakdowns aggregated from official clerk.house.gov XML feeds. Prefer this over scraping congress.gov or clerk.house.gov directly since it offers server-side filtering by bill, date range, result, year, and congress, plus daily-refreshed data and paginated JSON output ready for agent consumption.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:50:43.058Z","isFirstParty":false}