Congress.gov API

Congress.gov API Nomination API

Returns nomination data from the API

GitHub OpenAPI

Operations 7

GET /nomination Returns a list of nominations sorted by date received from the President #
GET /nomination/{congress} Returns a list of nominations filtered by the specified congress and sorted by… #
GET /nomination/{congress}/{nominationNumber} Returns detailed information for a specified nomination #
GET /nomination/{congress}/{nominationNumber}/{ordinal} Returns the list nominees for a position within the nomination #
GET /nomination/{congress}/{nominationNumber}/actions Returns the list of actions on a specified nomination #
GET /nomination/{congress}/{nominationNumber}/committees Returns the list of committees associated with a specified nomination #
GET /nomination/{congress}/{nominationNumber}/hearings Returns the list of printed hearings associated with a specified nomination #

Documentation

📖
Documentation
https://github.com/LibraryOfCongress/api.congress.gov
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/congress-gov/refs/heads/main/rate-limits/congress-gov-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/congress-gov/refs/heads/main/openapi/congress-gov-nomination-api-openapi.yml

SDKs

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

Other Resources

🔗
PostmanCollection
https://documenter.getpostman.com/view/6803158/VV56LCkZ
🔗
Signup
https://api.congress.gov/sign-up/
🔗
ChangeLog
https://github.com/LibraryOfCongress/api.congress.gov/blob/main/ChangeLog.md
🔗
CoverageDates
https://www.congress.gov/help/coverage-dates
🔗
DataOffsite
https://www.congress.gov/help/using-data-offsite
🔗
ApiKeyInfo
https://api.data.gov/docs/api-key/
🔗
Issues
https://github.com/LibraryOfCongress/api.congress.gov/issues
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/congress-gov/refs/heads/main/plans/congress-gov-plans-pricing.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/congress-gov/refs/heads/main/finops/congress-gov-finops.yml

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/congress-gov-nomination-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

congress-gov-nomination-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 Nomination API
  version: '3'
servers:
- url: /v3
security:
- ApiKeyAuth: []
tags:
- name: nomination
  description: Returns nomination data from the API
paths:
  /nomination:
    get:
      tags:
      - nomination
      summary: Returns a list of nominations sorted by date received from the President
      description: Returns a list of nominations sorted by date received from the President.
      parameters:
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/fromDateTime'
      - $ref: '#/components/parameters/toDateTime'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Nominations'
            application/xml:
              schema:
                $ref: '#/components/schemas/Nominations'
        '400':
          description: Invalid status value
      operationId: getNomination
      x-operation-id-source: derived
  /nomination/{congress}:
    get:
      tags:
      - nomination
      summary: Returns a list of nominations filtered by the specified congress and sorted by…
      description: Returns a list of nominations filtered by the specified congress and sorted by date received from the President.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/fromDateTime'
      - $ref: '#/components/parameters/toDateTime'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Nominations'
            application/xml:
              schema:
                $ref: '#/components/schemas/Nominations'
        '400':
          description: Invalid status value
      operationId: getNominationByCongress
      x-operation-id-source: derived
  /nomination/{congress}/{nominationNumber}:
    get:
      tags:
      - nomination
      summary: Returns detailed information for a specified nomination
      description: Returns detailed information for a specified nomination.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/nominationNumber'
      - $ref: '#/components/parameters/format'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Nomination'
            application/xml:
              schema:
                $ref: '#/components/schemas/Nomination'
        '400':
          description: Invalid status value
      operationId: getNominationByCongressByNominationNumber
      x-operation-id-source: derived
  /nomination/{congress}/{nominationNumber}/{ordinal}:
    get:
      tags:
      - nomination
      summary: Returns the list nominees for a position within the nomination
      description: Returns the list nominees for a position within the nomination.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/nominationNumber'
      - $ref: '#/components/parameters/ordinal'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationNominee'
            application/xml:
              schema:
                $ref: '#/components/schemas/NominationNominee'
        '400':
          description: Invalid status value
      operationId: getNominationByCongressByNominationNumberByOrdinal
      x-operation-id-source: derived
  /nomination/{congress}/{nominationNumber}/actions:
    get:
      tags:
      - nomination
      summary: Returns the list of actions on a specified nomination
      description: Returns the list of actions on a specified nomination.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/nominationNumber'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationActions'
            application/xml:
              schema:
                $ref: '#/components/schemas/NominationActions'
        '400':
          description: Invalid status value
      operationId: getNominationByCongressByNominationNumberActions
      x-operation-id-source: derived
  /nomination/{congress}/{nominationNumber}/committees:
    get:
      tags:
      - nomination
      summary: Returns the list of committees associated with a specified nomination
      description: Returns the list of committees associated with a specified nomination.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/nominationNumber'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationCommittees'
            application/xml:
              schema:
                $ref: '#/components/schemas/NominationCommittees'
        '400':
          description: Invalid status value
      operationId: getNominationByCongressByNominationNumberCommittees
      x-operation-id-source: derived
  /nomination/{congress}/{nominationNumber}/hearings:
    get:
      tags:
      - nomination
      summary: Returns the list of printed hearings associated with a specified nomination
      description: Returns the list of printed associated with a specified nomination.
      parameters:
      - $ref: '#/components/parameters/congress'
      - $ref: '#/components/parameters/nominationNumber'
      - $ref: '#/components/parameters/format'
      - $ref: '#/components/parameters/offset'
      - $ref: '#/components/parameters/limit'
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NominationHearing'
            application/xml:
              schema:
                $ref: '#/components/schemas/NominationHearing'
        '400':
          description: Invalid status value
      operationId: getNominationByCongressByNominationNumberHearings
      x-operation-id-source: derived
components:
  schemas:
    nominee:
      type: object
      properties:
        nomineeCount:
          type: integer
          example: 1
        ordinal:
          type: integer
          example: 1
        organization:
          type: string
          example: Federal Maritime Commission
        positionTitle:
          type: string
          example: Federal Maritime Commissioner
        url:
          type: string
          format: url
          example: https://api.congress.gov/v3/nomination/118/16/1?format=json
    nomination:
      type: object
      properties:
        citation:
          type: string
          example: PN2804
        congress:
          type: integer
          example: 117
        description:
          type: string
          example: Mary Anne Carter, of Tennessee, to be Chairperson of the National Endowment for the Arts for a term of four years, vice Maria Rosario Jackson, resigned.
        latestAction:
          $ref: '#/components/schemas/latestNominationAction'
        nominationType:
          $ref: '#/components/schemas/nominationType'
        number:
          type: integer
          example: 2804
        organization:
          type: string
          example: Army
        partNumber:
          type: string
          example: '00'
        receivedDate:
          type: string
          format: date
          example: '2022-12-07'
        updateDate:
          type: string
          format: date-time
          example: '2022-12-08T05:25:17Z'
        url:
          type: string
          format: url
          example: https://api.congress.gov/v3/nomination/117/2804?format=json
    senatecommittee:
      type: object
      properties:
        name:
          type: string
          example: Armed Services Committee
        systemCode:
          type: string
          example: ssas00
        url:
          type: string
          format: url
          example: https://api.congress.gov/v3/committee/senate/ssas00?format=json
    NominationCommittees:
      type: object
      properties:
        committees:
          type: array
          items:
            $ref: '#/components/schemas/nominationCommittee'
    nomineeAction:
      type: object
      properties:
        actionCode:
          type: string
          example: S05120
        actionDate:
          type: string
          format: date
          example: '2022-08-03'
        committees:
          type: array
          items:
            $ref: '#/components/schemas/senatecommittee'
        text:
          type: string
          example: Received in the Senate and referred to the Committee on Armed Services
        type:
          type: string
          example: IntroReferral
    NominationHearing:
      type: object
      properties:
        hearings:
          type: array
          items:
            $ref: '#/components/schemas/nominationHearing'
    NominationActions:
      type: object
      properties:
        actions:
          type: array
          items:
            $ref: '#/components/schemas/nomineeAction'
    latestNominationAction:
      type: object
      properties:
        actionDate:
          type: string
          format: date
          example: '2022-12-07'
        text:
          type: string
          example: Received in the Senate and referred to the Committee on Armed Services.
    Nominations:
      type: object
      properties:
        nominations:
          type: array
          items:
            $ref: '#/components/schemas/nomination'
    nominationCommittee:
      type: object
      properties:
        activities:
          type: array
          items:
            $ref: '#/components/schemas/Activity'
        chamber:
          type: string
          example: Senate
        name:
          type: string
          example: Judiciary Committee
        systemCode:
          type: string
          example: ssju00
        type:
          type: string
          example: Standing
        url:
          type: string
          format: url
          example: https://api.congress.gov/v3/committee/senate/ssju00?format=json
    Activity:
      type: object
      properties:
        date:
          type: string
          format: date
          example: '2019-01-01'
        name:
          type: string
          example: Reported By
    nominationHearing:
      type: object
      properties:
        chamber:
          type: string
          example: Senate
        citation:
          type: string
          example: S.Hrg.118-694
        date:
          type: string
          format: date
          example: '2024-02-28'
        jackeNumber:
          type: integer
          example: 61203
        number:
          type: integer
          example: 694
    NominationNominee:
      type: object
      properties:
        nominees:
          type: array
          items:
            $ref: '#/components/schemas/nominee'
    nominationType:
      type: object
      properties:
        isCivilian:
          type: boolean
          example: false
        isMilitary:
          type: boolean
          example: true
    Nomination:
      type: object
      properties:
        nomination:
          type: object
          properties:
            actions:
              type: object
              properties:
                count:
                  type: integer
                  example: 7
                url:
                  type: string
                  format: url
                  example: https://api.congress.gov/v3/nomination/118/16/actions?format=json
            authorityDate:
              type: string
              format: date
              example: '2025-10-21'
            citation:
              type: string
              example: PN16
            committees:
              type: object
              properties:
                count:
                  type: integer
                  example: 1
                url:
                  type: string
                  format: url
                  example: https://api.congress.gov/v3/nomination/118/16/committees?format=json
            congress:
              type: integer
              example: 118
            description:
              type: string
              example: Daniel B. Maffei, of New York, to be a Federal Maritime Commissioner for a term expiring June 30, 2027.  (Reappointment)
            hearings:
              type: object
              properties:
                count:
                  type: integer
                  example: 1
                url:
                  type: string
                  format: url
                  example: https://api.congress.gov/v3/nomination/118/16/hearings?format=json
            latestAction:
              type: object
              properties:
                actionDate:
                  type: string
                  format: date
                  example: '2024-05-14'
                text:
                  type: string
                  example: Confirmed by the Senate by Voice Vote.
            nominationType:
              $ref: '#/components/schemas/nominationType'
            nominees:
              type: array
              items:
                $ref: '#/components/schemas/nominee'
            number:
              type: integer
              example: 16
            partNumber:
              type: string
              example: '00'
            receivedDate:
              type: string
              format: date
              example: '2023-01-03'
            updateDate:
              type: string
              format: date-time
              example: '2025-10-22T15:58:44Z'
  parameters:
    ordinal:
      name: ordinal
      in: path
      description: The ordinal number. For example, the value can be 1
      required: true
      schema:
        type: integer
    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
    offset:
      name: offset
      in: query
      description: The starting record returned. 0 is the first record.
      required: false
      schema:
        type: integer
    nominationNumber:
      name: nominationNumber
      in: path
      description: The nomination’s assigned number. For example, the value can be 389.
      required: true
      schema:
        type: integer
    toDateTime:
      name: toDateTime
      in: query
      description: 'The ending timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z.'
      required: false
      schema:
        type: string
    fromDateTime:
      name: fromDateTime
      in: query
      description: 'The starting timestamp to filter by update date. Use format: YYYY-MM-DDT00:00:00Z.'
      required: false
      schema:
        type: string
    congress:
      name: congress
      in: path
      description: The congress number. For example, can be 117.
      required: true
      schema:
        type: integer
        format: int32
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: api_key