Endpoints

Votes API

Retrieve House roll call details, member positions, and rollups by Congress, party, state, member, position, and policy area.

Auth

Authorization: Bearer API key

Current base

/api/legislative

Version target

/api/v1

House votes

Current development endpoints for vote detail and analytics.

GET/api/legislative/house-votes/{congress}/{session}/{rollCallNumber}

House vote detail

Returns a House roll call vote, linked bill, position summary, member vote positions, and keyset-style member position pagination.

currentdeveloper_free or higher

Source

House Clerk / Congress.gov-linked records

Scopes

votes:read

Parameters

NameRequiredDescription
qnoFilter member positions by name or Bioguide ID.
partynoFilter member positions by party.
statenoFilter member positions by state.
positionnoFilter by yea, nay, present, or not_voting.
afterIdnoCursor for large member position lists. Pass the previous response's nextAfterId to continue.
limitnoMaximum member positions to return. Defaults to 500 and is capped at 500.

Request example

curl -H "Authorization: Bearer $LAWLINTER_API_KEY" "https://example.com/api/legislative/house-votes/119/1/45?position=yea&limit=50"

Response example

{
  "vote": {"congress": 119, "session": 1, "rollCallNumber": 45},
  "summary": {"yea": 214, "nay": 205, "notVoting": 12},
  "positions": [{"member": "Example Member", "position": "Yea"}],
  "nextAfterId": 12345
}
GET/api/legislative/house-votes/analytics

House vote analytics

Returns vote rollups by Congress, session, party, state, position, member, and policy-area filters.

currentanalysis plan or higher

Source

House vote normalized tables

Scopes

votes:read

Parameters

NameRequiredDescription
congressnoCongress number.
sessionnoSession number.
policyAreanoLinked bill policy area.
partynoParty filter.
statenoState filter.
bioguideIdnoMember filter.
includeMembersnoInclude member-level rollups when true.
limitnoMaximum rollups to return per section. Defaults to 100 and is capped at 500.

Request example

curl -H "Authorization: Bearer $LAWLINTER_API_KEY" "https://example.com/api/legislative/house-votes/analytics?congress=119&state=TX&includeMembers=true"

Response example

{"totals": {"votes": 25, "positions": 10800}, "byParty": [], "members": []}

Need an API key?

Create and revoke keys from your account API access page when your subscription allows API usage.