Library of Congress · Schema
Congress.gov API Schemas
JSON Schema definitions extracted from the Congress.gov API OpenAPI specification
LibraryGovernmentCongressLegislative DataDigital CollectionsNewspapersMapsBibliographic RecordsHistorical Documents
JSON Schema
{
"$schema": "http://json-schema.org/draft-07/schema#",
"title": "Congress.gov API Schemas",
"description": "JSON Schema definitions extracted from the Congress.gov API OpenAPI specification",
"definitions": {
"Bill": {
"xml": {
"wrapped": false
},
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 119
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2025-11-21"
},
"text": {
"type": "string",
"example": "Read twice and referred to the Committee on Agriculture, Nutrition, and Forestry."
}
}
},
"number": {
"type": "string",
"example": 3281
},
"originChamber": {
"type": "string",
"example": "Senate"
},
"originChamberCode": {
"type": "string",
"example": "S"
},
"title": {
"type": "string",
"example": "A bill to repeal certain provisions relating to nutrition."
},
"type": {
"type": "string",
"example": "S"
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2025-11-21"
},
"updateDateIncludingText": {
"type": "string",
"format": "date-time",
"example": "2025-11-21"
},
"url": {
"type": "string",
"format": "url",
"example": "http://api.congress.gov/v3/bill/119/s/3281?format=xml"
}
}
},
"laws": {
"type": "object",
"properties": {
"number": {
"type": "string",
"example": "117-108"
},
"type": {
"type": "string",
"example": "Public Law"
}
}
},
"Law": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 119
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2025-11-21"
},
"text": {
"type": "string",
"example": "Became Public Law No: 119-37."
}
}
},
"laws": {
"type": "array",
"items": {
"$ref": "#/components/schemas/laws"
}
},
"number": {
"type": "string",
"example": "2808"
},
"originChamber": {
"type": "string",
"example": "House"
},
"originChamberCode": {
"type": "string",
"example": "H"
},
"title": {
"type": "string",
"example": "Homebuyers Privacy Protection Act"
},
"type": {
"type": "string",
"example": "HR"
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2025-11-21"
},
"updateDateIncludingText": {
"type": "string",
"format": "date-time",
"example": "2025-11-21"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/119/hr/2808?format=json"
}
}
},
"cboCost": {
"type": "object",
"properties": {
"description": {
"type": "string",
"example": "As ordered reported by the House Committee on Oversight and Accountability on September 20, 2023\n"
},
"pubDate": {
"type": "string",
"format": "date",
"example": "2023-10-10T19:58:00Z"
},
"title": {
"type": "string",
"example": "H.R. 4984, D.C. Robert F. Kennedy Memorial Stadium Campus Revitalization Act"
},
"url": {
"type": "string",
"format": "url",
"example": "https://www.cbo.gov/publication/59651"
}
}
},
"committeeReport": {
"type": "object",
"properties": {
"citation": {
"type": "string",
"example": "H. Rept. 118-400"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/committee-report/118/HRPT/400?format=json"
}
}
},
"LawNumber": {
"type": "object",
"properties": {
"actions": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/law/118/hr/4984/actions?format=json"
}
}
},
"cboCostEstimates": {
"type": "array",
"items": {
"$ref": "#/components/schemas/cboCost"
}
},
"committeeReports": {
"type": "array",
"items": {
"$ref": "#/components/schemas/committeeReport"
}
},
"committees": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/law/118/hr/4984/committees?format=json"
}
}
},
"congress": {
"type": "integer",
"example": 118
},
"constitutionalAuthorityStatementText": {
"type": "string",
"example": "<pre>\n[Congressional Record Volume 169, Number 130 (Thursday, July 27, 2023)]\n[House]\n[Pages H4143-H4144]\nFrom the Congressional Record Online through the Government Publishing Office [<a href=\"https://www.gpo.gov\">www.gpo.gov</a>]\nBy Mr. COMER:\nH.R. 4984.\nCongress has the power to enact this legislation pursuant\nto the following:\nArticle I, Section 8, Clause 17 of the U.S. Constitution,\nin that the legislation ``to exercise exclusive Legislation\nin all Cases\n[[Page H4144]]\nwhatsoever, over such District (not exceeding ten Miles\nsquare) as may, by Cession of particular States, and the\nAcceptance of Congress, become the Seat of the Government of\nthe United States, and to exercise like Authority over all\nPlaces purchased by the Consent of the Legislature of the\nState in which the Same shall be, for the Erection of Forts,\nMagazines, Arsenals, dock-Yards, and other needful\nBuildings.''\nThe single subject of this legislation is:\nTo transfer administrative jurisdiction of the District of\nColumbia RFK Memorial Stadium campus from the Secretary of\nthe Interior to the Administrator of General Services and\nauthorize a new lease with D.C. for redevelopment.\n</pre>"
},
"cosponsors": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 21
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/law/118/hr/4984/cosponsors?format=json"
}
}
},
"introducedDate": {
"type": "string",
"format": "date",
"example": "2023-07-27"
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2025-01-06"
},
"text": {
"type": "string",
"example": "Became Public Law No: 118-274."
}
}
},
"laws": {
"type": "array",
"items": {
"$ref": "#/components/schemas/laws"
}
},
"number": {
"type": "string",
"example": "4984"
},
"originChamber": {
"type": "string",
"example": "House"
},
"originChamberCode": {
"type": "string",
"example": "H"
},
"policyArea": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Government Operations and Politics"
}
}
},
"sponsors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Sponsor"
}
},
"subjects": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 11
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/bill/118/hr/4984/subjects?format=json"
}
}
},
"summaries": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 5
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/118/hr/4984/summaries?format=json"
}
}
},
"textVersions": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 6
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/118/hr/4984/textversions?format=json"
}
}
},
"title": {
"type": "string",
"example": "D.C. Robert F. Kennedy Memorial Stadium Campus Revitalization Act"
},
"titles": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 9
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/bill/118/hr/4984/titles?format=json"
}
}
},
"type": {
"type": "string",
"example": "HR"
},
"updateDate": {
"type": "string",
"format": "date-time",
"example": "2025-05-27T14:16:54Z"
},
"updateDateIncludingText": {
"type": "string",
"format": "date-time",
"example": "2025-05-27T14:16:54Z"
}
}
},
"BillDetail": {
"type": "object",
"properties": {
"actions": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/bill/117/s/1234/actions?format=json"
}
}
},
"committees": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"example": "https://api.congress.gov/v3/bill/117/s/1234/committees?format=json"
}
}
},
"congress": {
"type": "integer",
"example": 117
},
"introducedDate": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"text": {
"type": "string"
}
}
},
"legislationUrl": {
"type": "string",
"format": "url",
"example": "https://www.congress.gov/bill/117th-congress/senate-bill/1234"
},
"number": {
"type": "string",
"example": 1234
},
"originChamber": {
"type": "string",
"example": "Senate"
},
"originChamberCode": {
"type": "string",
"example": "S"
},
"policyArea": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Health"
}
}
},
"relatedBills": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/117/s/1234/relatedbills?format=json"
},
"sponsors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Sponsor"
}
}
}
},
"Sponsor": {
"type": "object",
"properties": {
"bioguideId": {
"type": "string",
"example": "G000555"
},
"firstName": {
"type": "string",
"example": "Bill"
},
"lastName": {
"type": "string",
"example": "Washington"
},
"fullName": {
"type": "string",
"example": "Senator Bill Washington [I-NY]"
},
"isByRequest": {
"type": "string",
"example": "N"
},
"middleName": {
"type": "string",
"example": "J."
},
"party": {
"type": "string",
"example": "I"
},
"state": {
"type": "string",
"example": "VA"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/member/G000555?format=json"
}
}
},
"Actions": {
"type": "object",
"properties": {
"actionCode": {
"type": "string",
"example": "36000"
},
"actionDate": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"sourceSystem": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"example": 1
},
"name": {
"type": "string",
"example": "Library of Congress"
}
}
},
"text": {
"type": "string",
"example": "Became Public Law No: 117-108."
},
"type": {
"type": "string",
"example": "BecameLaw"
}
}
},
"Amendments": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 117
},
"description": {
"type": "string",
"example": "Pursuant to the provisions of H. Res. 912, the amendment in the nature of a substitute consisting of the text of Rules Committee Print 117-32 is considered as adopted."
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"text": {
"type": "string",
"example": "On agreeing to the Maloney, Carolyn B. amendment (A002) Agreed to by voice vote. "
}
}
},
"number": {
"type": "string",
"example": "173"
},
"type": {
"type": "string",
"example": "HAMDT"
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/amendment/117/hamdt/173?format=json"
}
}
},
"Activity": {
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"name": {
"type": "string",
"example": "Reported By"
}
}
},
"Committee": {
"type": "object",
"properties": {
"activities": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Activity"
}
},
"chamber": {
"type": "string",
"example": "House"
},
"name": {
"type": "string",
"example": "House Committee on the Judiciary"
},
"systemCode": {
"type": "string",
"example": "hsgo00"
},
"type": {
"type": "string",
"example": "Standing"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/committee/house/hsgo00?format=json"
}
}
},
"CoSponsor": {
"type": "object",
"properties": {
"bioguidId": {
"type": "string",
"example": "F000450"
},
"district": {
"type": "integer",
"example": 5
},
"firstName": {
"type": "string",
"example": "Virginia"
},
"fullName": {
"type": "string",
"example": "Rep. Foxx, Virginia [R-NC-5]"
},
"isOriginalCosponsor": {
"type": "boolean",
"example": true
},
"lastName": {
"type": "string",
"example": "Foxx"
},
"party": {
"type": "string",
"example": "R"
},
"sponsorshipDate": {
"type": "string",
"format": "date",
"example": "2021-05-11"
},
"state": {
"type": "string",
"example": "NC"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/member/F000450?format=json"
}
}
},
"relationshipDetails": {
"type": "object",
"properties": {
"identifiedBy": {
"type": "string",
"example": "CRS"
},
"type": {
"type": "string",
"example": "Related Bill"
}
}
},
"RelatedBills": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 117
},
"lastestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2019-01-01"
},
"text": {
"type": "string",
"example": "On agreeing to the Maloney, Carolyn B. amendment (A002) Agreed to by voice vote. "
}
}
},
"number": {
"type": "integer",
"example": 1720
},
"relationshipDetails": {
"type": "array",
"items": {
"$ref": "#/components/schemas/relationshipDetails"
}
}
}
},
"legislativeSubjects": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Congressional oversight"
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
}
}
},
"policyArea": {
"type": "object",
"properties": {
"name": {
"type": "string",
"example": "Government Operations and Politics"
}
}
},
"Subjects": {
"type": "object",
"properties": {
"legislativeSubjects": {
"type": "array",
"items": {
"$ref": "#/components/schemas/legislativeSubjects"
}
},
"policyArea": {
"$ref": "#/components/schemas/policyArea"
}
}
},
"billSummariesArray": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"actionDesc": {
"type": "string",
"example": "Passed Senate"
},
"text": {
"type": "string",
"example": "<p><strong>COVID-19 Medical Production Act</strong></p> <p>This bill provides additional funding for FY2021 to acquire medical supplies, vaccines, and other equipment to combat COVID-19 (i.e., coronavirus disease 2019) using authorities under the Defense Production Act of 1950. That act confers on the President a broad set of authorities to influence domestic industry to provide essential materials and goods for the national defense.</p> <p>This funding is available through FY2025. Beginning in FY2023, it may be used to meet public health needs to address any pathogen determined by the President to have the potential to create a public health emergency.</p>"
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"versionCode": {
"type": "string",
"example": "173"
}
}
},
"BillSummaries": {
"type": "array",
"items": {
"$ref": "#/components/schemas/billSummariesArray"
}
},
"formats": {
"type": "object",
"properties": {
"type": {
"type": "string",
"example": "Formatted Text"
},
"url": {
"type": "string",
"format": "url",
"example": "https://www.congress.gov/117/bills/hr3076/BILLS-117hr3076enr.htm"
}
}
},
"textVersions": {
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"formats": {
"type": "array",
"items": {
"$ref": "#/components/schemas/formats"
}
},
"type": {
"type": "string",
"example": "Enrolled Bill"
}
}
},
"Text": {
"type": "array",
"items": {
"$ref": "#/components/schemas/textVersions"
}
},
"titlesArray": {
"type": "object",
"properties": {
"title": {
"type": "string",
"example": "A bill to amend the Health and Human Services Act of 1968 to provide for the establishment of a national health care system."
},
"updateDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"titleType": {
"type": "string",
"example": "Display Title"
},
"titleTypeCode": {
"type": "integer",
"example": 45
},
"billTextVersionCode": {
"type": "string",
"example": "RH"
},
"billTextVersionName": {
"type": "string",
"example": "Reported in House"
}
}
},
"Titles": {
"type": "array",
"items": {
"$ref": "#/components/schemas/titlesArray"
}
},
"Amendment": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 117
},
"description": {
"type": "string",
"example": "Amendment changes the effective date of the bill to the date of enactment."
},
"latestAction": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2021-08-08"
},
"actionTime": {
"type": "string",
"format": "time",
"example": "12:00:00"
},
"text": {
"type": "string",
"example": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28. Record Vote Number: 312."
}
}
},
"number": {
"type": "string",
"example": "2137"
},
"purpose": {
"type": "string",
"example": "In the nature of a substitute."
},
"type": {
"type": "string",
"format": "SAMDT"
},
"updateDate": {
"type": "string",
"format": "date-time",
"example": "2021-08-08T12:00:00Z"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/amendment/117/samdt/2137?format=json"
}
}
},
"amendedBill": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 117
},
"number": {
"type": "string",
"example": "5"
},
"originChamber": {
"type": "string",
"example": "Senate"
},
"originChamberCode": {
"type": "string",
"example": "S"
},
"title": {
"type": "string",
"example": "A concurrent resolution setting forth the congressional budget for the United States Government for fiscal year 2021 and setting forth the appropriate budgetary levels for fiscal years 2022 through 2030."
},
"type": {
"type": "string",
"example": "SCONRES"
},
"updateDateIncludingText": {
"type": "string",
"format": "date",
"example": "2025-04-07"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/117/sconres/5?format=json"
}
}
},
"textVersion": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/amendment/117/samdt/4/text?format=json"
}
}
},
"AmendmentNumber": {
"type": "object",
"properties": {
"actions": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/amendment/117/samdt/4/actions?format=json"
}
}
},
"amendedBill": {
"$ref": "#/components/schemas/amendedBill"
},
"chamber": {
"type": "string"
},
"congress": {
"type": "integer",
"example": 117
},
"number": {
"type": "string",
"example": "2137"
},
"sponsors": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Sponsor"
}
},
"submittedDate": {
"type": "string",
"format": "date-time",
"example": "2021-02-02T05:00:00Z"
},
"textVersions": {
"$ref": "#/components/schemas/textVersion"
},
"type": {
"type": "string",
"format": "SAMDT"
},
"updateDate": {
"type": "string",
"format": "date-time",
"example": "2021-08-08T12:00:00Z"
}
}
},
"recordedVote": {
"type": "object",
"properties": {
"chamber": {
"type": "string",
"example": "Senate"
},
"congress": {
"type": "integer",
"example": 117
},
"date": {
"type": "string",
"format": "date-time",
"example": "2021-08-08T12:00:00Z"
},
"rollNumber": {
"type": "integer",
"example": 312
},
"sessionNumber": {
"type": "integer",
"example": 1
},
"url": {
"type": "string",
"format": "url",
"example": "https://www.senate.gov/legislative/LIS/roll_call_votes/vote1171/vote_117_1_00312.xml"
}
}
},
"sourceSystem": {
"type": "object",
"properties": {
"code": {
"type": "integer",
"example": 0
},
"name": {
"type": "string",
"example": "Senate"
}
}
},
"amendmentActions": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2021-08-08"
},
"recordedVotes": {
"type": "array",
"items": {
"$ref": "#/components/schemas/recordedVote"
}
},
"sourceSystem": {
"$ref": "#/components/schemas/sourceSystem"
},
"text": {
"type": "string",
"example": "Amendment SA 2137 agreed to in Senate by Yea-Nay Vote. 69 - 28. Record Vote Number: 312."
},
"type": {
"type": "string",
"example": "Floor"
}
}
},
"AmendmentActions": {
"type": "array",
"items": [
{
"$ref": "#/components/schemas/amendmentActions"
}
]
},
"AmendmentCosponsors": {
"type": "array",
"items": [
{
"$ref": "#/components/schemas/CoSponsor"
}
]
},
"AmendmentAmendments": {
"type": "array",
"items": [
{
"$ref": "#/components/schemas/Amendment"
}
]
},
"AmendmentText": {
"type": "array",
"items": [
{
"$ref": "#/components/schemas/textVersions"
}
]
},
"summaryBill": {
"type": "object",
"properties": {
"congress": {
"type": "integer",
"example": 117
},
"number": {
"type": "string",
"example": 1234
},
"originChamber": {
"type": "string",
"example": "Senate"
},
"originChamberCode": {
"type": "string",
"example": "S"
},
"title": {
"type": "string",
"example": "Pay Our Capitol Police Act"
},
"type": {
"type": "string",
"example": "HR"
},
"updateDateIncludingText": {
"type": "string",
"format": "date",
"example": "2021-08-08"
},
"url": {
"type": "string",
"format": "url",
"example": "https://api.congress.gov/v3/bill/117/hr/1234?format=json"
}
}
},
"summariesArray": {
"type": "object",
"properties": {
"actionDate": {
"type": "string",
"format": "date",
"example": "2022-02-18T16:38:41Z"
},
"actionDesc": {
"type": "string",
"example": "Passed Senate"
},
"bill": {
"$ref": "#/components/schemas/summaryBill"
},
"currentChamber": {
"type": "string",
"example": "Senate"
},
"currentChamberCode": {
"type": "string",
"example": "S"
},
"lastSummaryUpdateDate": {
"type": "string",
"format": "date-time",
"example": "2022-02-18T16:38:41Z"
},
"text": {
"type": "string",
"example": "<p><strong>COVID-19 Medical Production Act</strong></p> <p>This bill provides additional funding for FY2021 to acquire medical supplies, vaccines, and other equipment to combat COVID-19 (i.e., coronavirus disease 2019) using authorities under the Defense Production Act of 1950. That act confers on the President a broad set of authorities to influence domestic industry to provide essential materials and goods for the national defense.</p> <p>This funding is available through FY2025. Beginning in FY2023, it may be used to meet public health needs to address any pathogen determined by the President to have the potenti
# --- truncated at 32 KB (115 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/loc/refs/heads/main/json-schema/loc-congress-gov-schema.json