Congress.gov Bill

Schema for a congressional bill from the Congress.gov API v3

Federal GovernmentLegislationCongressLegislative DataBillsMembersCommittees

Properties

Name	Type	Description
congress	integer	Congress number (e.g., 119 for the 119th Congress)
type	string	Bill type code
number	string	Bill number within its type
title	string	Official title of the bill
originChamber	string	Chamber where the bill originated
originChamberCode	string	Single-letter chamber code
introducedDate	string	Date the bill was introduced
latestAction	object	Most recent legislative action on the bill
sponsors	array	Primary sponsors of the bill
cosponsors	object	Cosponsors data with count and URL
committees	object	Committee referrals with count and URL
subjects	object	Legislative subject terms
updateDate	string	When the bill record was last updated in Congress.gov
url	string	API URL for this bill's details

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/us-house-of-representatives/main/json-schema/congress-gov-bill-schema.json",
  "title": "Congress.gov Bill",
  "description": "Schema for a congressional bill from the Congress.gov API v3",
  "type": "object",
  "properties": {
    "congress": {
      "type": "integer",
      "description": "Congress number (e.g., 119 for the 119th Congress)"
    },
    "type": {
      "type": "string",
      "description": "Bill type code",
      "enum": ["HR", "S", "HJRES", "SJRES", "HCONRES", "SCONRES", "HRES", "SRES"]
    },
    "number": {
      "type": "string",
      "description": "Bill number within its type"
    },
    "title": {
      "type": "string",
      "description": "Official title of the bill"
    },
    "originChamber": {
      "type": "string",
      "description": "Chamber where the bill originated",
      "enum": ["House", "Senate"]
    },
    "originChamberCode": {
      "type": "string",
      "description": "Single-letter chamber code",
      "enum": ["H", "S"]
    },
    "introducedDate": {
      "type": "string",
      "format": "date",
      "description": "Date the bill was introduced"
    },
    "latestAction": {
      "type": "object",
      "description": "Most recent legislative action on the bill",
      "properties": {
        "actionDate": {
          "type": "string",
          "format": "date",
          "description": "Date of the latest action"
        },
        "text": {
          "type": "string",
          "description": "Description of the latest action"
        }
      }
    },
    "sponsors": {
      "type": "array",
      "description": "Primary sponsors of the bill",
      "items": {
        "type": "object",
        "properties": {
          "bioguideId": {
            "type": "string",
            "description": "Sponsor's Bioguide ID"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "party": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "district": {
            "type": "integer",
            "nullable": true
          }
        }
      }
    },
    "cosponsors": {
      "type": "object",
      "description": "Cosponsors data with count and URL",
      "properties": {
        "count": {
          "type": "integer"
        },
        "url": {
          "type": "string"
        }
      }
    },
    "committees": {
      "type": "object",
      "description": "Committee referrals with count and URL"
    },
    "subjects": {
      "type": "object",
      "description": "Legislative subject terms"
    },
    "updateDate": {
      "type": "string",
      "format": "date-time",
      "description": "When the bill record was last updated in Congress.gov"
    },
    "url": {
      "type": "string",
      "description": "API URL for this bill's details"
    }
  },
  "required": ["congress", "type", "number", "title", "introducedDate"]
}