gov

US Senate roll-call votes, newest first by vote date.

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.

get/api/gov/senate-votes

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/gov/senate-votes
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

congressinteger

Filter by Congress number. The 119th Congress = 2025-2026.

sessioninteger

Filter by session (1 = odd year, 2 = even year of a Congress).

resultstring

Filter by vote result (case-insensitive substring). Examples: "Agreed", "Rejected", "Cloture".

documentstring

Filter by document name substring (case-insensitive on document_name). Examples: "S. 5", "H.R. 4499", "H.R.".

sincestring

Earliest vote date (YYYY-MM-DD).

untilstring

Latest vote date (YYYY-MM-DD).

limitinteger

Max records (1-100). Default 25.

offsetinteger

Offset for pagination. Default 0.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.