Library of Congress

Library of Congress House Vote API

[BETA] Returns House of Representatives roll call vote data from the API

GitHub OpenAPI
Business capability
Legislative Process Coordination BC-3210.50

Operations 5

GET /house-vote Returns House of Representatives roll call vote data from the API. #
GET /house-vote/{congress} Returns House of Representatives roll call vote data from the API filtered by… #
GET /house-vote/{congress}/{session} Returns House of Representatives roll call vote data from the API filtered by… #
GET /house-vote/{congress}/{session}/{voteNumber} Returns detailed information for a specified House of Representatives roll call… #
GET /house-vote/{congress}/{session}/{voteNumber}/members Returns detailed information for how members voted on a specified House of… #

Documentation

📖
Documentation
https://www.loc.gov/apis/json-and-yaml/
📖
Documentation
https://api.congress.gov/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/loc/refs/heads/main/openapi/loc-house-vote-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/LibraryOfCongress/api.congress.gov

Other Resources

🔗
Signup
https://api.congress.gov/sign-up/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/loc-house-vote-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

loc-house-vote-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Congress.gov shares its application programming interface (API) with the public to ingest the Congressional data. Sign up for an API key from api.data.gov that you can use to access web services provided by Congress.gov. To learn more, view our GitHub repository.
  title: Congress.gov House Vote API
  version: '3'
servers:
- url: /v3
security:
- ApiKeyAuth: []
tags:
- name: house-vote
  description: '[BETA] Returns House of Representatives roll call vote data from the API'
paths:
  /house-vote:
    get:
      tags:
      - house-vote
      summary: Returns House of Representatives roll call vote data from the API.
      description: Returns House of Representatives roll call vote data from the API. This endpoint is currently in beta.
      parameters:
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HouseVote'
            application/xml:
              schema:
                $ref: '#/components/schemas/HouseVote'
        '400':
          description: Invalid status value
      operationId: getHouseVote
      x-operation-id-source: derived
  /house-vote/{congress}:
    get:
      tags:
      - house-vote
      summary: Returns House of Representatives roll call vote data from the API filtered by…
      description: Returns House of Representatives roll call vote data from the API filtered by the specified Congress. This endpoint is currently in beta.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HouseVote'
            application/xml:
              schema:
                $ref: '#/components/schemas/HouseVote'
        '400':
          description: Invalid status value
      operationId: getHouseVoteByCongress
      x-operation-id-source: derived
  /house-vote/{congress}/{session}:
    get:
      tags:
      - house-vote
      summary: Returns House of Representatives roll call vote data from the API filtered by…
      description: Returns House of Representatives roll call vote data from the API filtered by the specified Congress and session. This endpoint is currently in beta.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/session'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HouseVote'
            application/xml:
              schema:
                $ref: '#/components/schemas/HouseVote'
        '400':
          description: Invalid status value
      operationId: getHouseVoteByCongressBySession
      x-operation-id-source: derived
  /house-vote/{congress}/{session}/{voteNumber}:
    get:
      tags:
      - house-vote
      summary: Returns detailed information for a specified House of Representatives roll call…
      description: Returns detailed information for a specified House of Representatives roll call vote. This endpoint is currently in beta.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/session'
      - $ref: '#/components/parameters/voteNumber'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HouseVoteNumber'
            application/xml:
              schema:
                $ref: '#/components/schemas/HouseVoteNumber'
        '400':
          description: Invalid status value
      operationId: getHouseVoteByCongressBySessionByVoteNumber
      x-operation-id-source: derived
  /house-vote/{congress}/{session}/{voteNumber}/members:
    get:
      tags:
      - house-vote
      summary: Returns detailed information for how members voted on a specified House of…
      description: Returns detailed information for how members voted on a specified House of Representatives roll call vote. This endpoint is currently in beta.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/session'
      - $ref: '#/components/parameters/voteNumber'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HouseVoteMembers'
            application/xml:
              schema:
                $ref: '#/components/schemas/HouseVoteMembers'
        '400':
          description: Invalid status value
      operationId: getHouseVoteByCongressBySessionByVoteNumberMembers
      x-operation-id-source: derived
components:
  parameters:
    voteNumber:
      name: voteNumber
      in: path
      description: The assigned roll call vote number. For example, 17.
      required: true
      schema:
        type: integer
    session:
      name: session
      in: path
      description: The session number. The value can be 1 or 2.
      required: true
      schema:
        type: integer
        enum:
        - 1
        - 2
    offset:
      name: offset
      in: query
      description: The starting record returned. 0 is the first record.
      required: false
      schema:
        type: integer
    congress:
      name: congress
      in: path
      description: The congress number. For example, can be 117.
      required: true
      schema:
        type: integer
        format: int32
    format:
      name: format
      in: query
      description: The data format. Value can be xml or json.
      required: false
      schema:
        type: string
        default: xml
        enum:
        - xml
        - json
    limit:
      name: limit
      in: query
      description: The number of records returned. The maximum limit is 250.
      required: false
      schema:
        type: integer
  schemas:
    HouseVoteNumberBase:
      type: object
      properties:
        congress:
          type: integer
          example: 119
        identifier:
          type: integer
          example: 1191202517
        legislationNumber:
          type: string
          example: '30'
        legislationType:
          type: string
          example: HR
        legislationUrl:
          type: string
          format: url
          example: https://congress.gov/bill/119/house-bill/30
        result:
          type: string
          example: Passed
        rollCallNumber:
          type: integer
          example: 17
        sessionNumber:
          type: integer
          example: 1
        sourceDataURL:
          type: string
          example: https://clerk.house.gov/evs/2025/roll017.xml
        startDate:
          type: string
          format: date-time
          example: '2025-01-16T11:00:00-05:00'
        updateDate:
          type: string
          format: date-time
          example: '2025-04-18T08:44:47-04:00'
        voteType:
          type: string
          example: Yea-and-Nay
    HouseVote:
      type: object
      properties:
        congress:
          type: integer
          example: 119
        identifier:
          type: integer
          example: 1191202517
        legislationNumber:
          type: string
          example: '30'
        legislationType:
          type: string
          example: HR
        legislationUrl:
          type: string
          format: url
          example: https://congress.gov/bill/119/house-bill/30
        result:
          type: string
          example: Passed
        rollCallNumber:
          type: integer
          example: 17
        sessionNumber:
          type: integer
          example: 1
        sourceDataURL:
          type: string
          example: https://clerk.house.gov/evs/2025/roll017.xml
        startDate:
          type: string
          format: date-time
          example: '2025-01-16T11:00:00-05:00'
        updateDate:
          type: string
          format: date-time
          example: '2025-04-18T08:44:47-04:00'
        url:
          type: string
          format: url
          example: https://api.congress.gov/v3/house-vote/119/1/17
        voteType:
          type: string
          example: Yea-and-Nay
    HouseVoteMembers:
      allOf:
      - $ref: '#/components/schemas/HouseVoteNumberBase'
      - type: object
        properties:
          results:
            type: array
            items:
              $ref: '#/components/schemas/houseVoteResults'
          voteQuestion:
            type: string
            example: On Passage
    voteParty:
      type: object
      properties:
        nayTotal:
          type: integer
          example: 0
        notVotingTotal:
          type: integer
          example: 6
        presentTotal:
          type: integer
          example: 0
        voteParty:
          type: string
          example: R
        yeaTotal:
          type: integer
          example: 213
        party:
          $ref: '#/components/schemas/party'
    houseVoteResults:
      type: object
      properties:
        bioguideID:
          type: string
          example: A000055
        firstName:
          type: string
          example: Robert
        lastName:
          type: string
          example: Aderholt
        voteCast:
          type: string
          example: Yea
        voteParty:
          type: string
          example: R
        voteState:
          type: string
          example: AL
    HouseVoteNumber:
      allOf:
      - $ref: '#/components/schemas/HouseVoteNumberBase'
      - type: object
        properties:
          votePartyTotal:
            type: array
            items:
              $ref: '#/components/schemas/voteParty'
          voteQuestion:
            type: string
            example: On Passage
    party:
      type: object
      properties:
        name:
          type: string
          example: Republican
        type:
          type: string
          example: R
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: api_key