Library of Congress bill API
Returns bill data from the API
OpenAPI Specification
openapi: 3.0.3
info:
description: 'Congress.gov shares its application programming interface (API) with the public to ingest the Congressional data. <a href="sign-up/" target="_blank">Sign up for an API key</a> from api.data.gov that you can use to access web services provided by Congress.gov. To learn more, view our <a href="https://github.com/LibraryOfCongress/api.congress.gov/" target="_blank">GitHub repository</a>.
'
title: Congress.gov amendments bill API
version: '3'
servers:
- url: /v3
security:
- ApiKeyAuth: []
tags:
- name: bill
description: Returns bill data from the API
paths:
/bill:
get:
tags:
- bill
summary: Returns a list of bills sorted by date of latest action
description: Returns a list of bills sorted by date of latest action
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/Bill'
application/xml:
schema:
$ref: '#/components/schemas/Bill'
'400':
description: Invalid status value
/bill/{congress}:
get:
tags:
- bill
summary: Returns a list of bills filtered by the specified congress, sorted by date of latest action
description: Returns a list of bills filtered by the specified congress, sorted by date of latest action
parameters:
- name: congress
in: path
description: The congress number. For example, can be 117.
required: true
schema:
type: integer
format: int32
- $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/Bill'
application/xml:
schema:
$ref: '#/components/schemas/Bill'
'400':
description: Invalid status value
/bill/{congress}/{billType}:
get:
tags:
- bill
summary: Returns a list of bills filtered by the specified congress and bill type, sorted by date of latest action.
description: Returns a list of bills filtered by the specified congress and bill type, sorted by date of latest action.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $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/Bill'
application/xml:
schema:
$ref: '#/components/schemas/Bill'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}:
get:
tags:
- bill
summary: Returns detailed information for a specified bill.
description: Returns detailed information for a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $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/BillDetail'
application/xml:
schema:
$ref: '#/components/schemas/BillDetail'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/actions:
get:
tags:
- bill
summary: Returns the list of actions on a specified bill.
description: Returns the list of actions on a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $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/Actions'
application/xml:
schema:
$ref: '#/components/schemas/Actions'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/amendments:
get:
tags:
- bill
summary: Returns the list of amendments to a specified bill.
description: Returns the list of amendments to a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $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/Amendments'
application/xml:
schema:
$ref: '#/components/schemas/Amendments'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/committees:
get:
tags:
- bill
summary: Returns the list of committees associated with a specified bill.
description: Returns the list of committees associated with a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/Committee'
application/xml:
schema:
$ref: '#/components/schemas/Committee'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/cosponsors:
get:
tags:
- bill
summary: Returns the list of cosponsors on a specified bill.
description: Returns the list of cosponsors on a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
- $ref: '#/components/parameters/fromDateTime'
- $ref: '#/components/parameters/toDateTime'
- $ref: '#/components/parameters/sort'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/CoSponsor'
application/xml:
schema:
$ref: '#/components/schemas/CoSponsor'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/relatedbills:
get:
tags:
- bill
summary: Returns the list of related bills to a specified bill.
description: Returns the list of related bills to a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/RelatedBills'
application/xml:
schema:
$ref: '#/components/schemas/RelatedBills'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/subjects:
get:
tags:
- bill
summary: Returns the list of legislative subjects on a specified bill.
description: Returns the list of legislative subjects on a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $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/Subjects'
application/xml:
schema:
$ref: '#/components/schemas/Subjects'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/summaries:
get:
tags:
- bill
summary: Returns the list of summaries for a specified bill.
description: Returns the list of summaries for a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/BillSummaries'
application/xml:
schema:
$ref: '#/components/schemas/BillSummaries'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/text:
get:
tags:
- bill
summary: Returns the list of text versions for a specified bill.
description: Returns the list of text versions for a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/Text'
application/xml:
schema:
$ref: '#/components/schemas/Text'
'400':
description: Invalid status value
/bill/{congress}/{billType}/{billNumber}/titles:
get:
tags:
- bill
summary: Returns the list of titles for a specified bill.
description: Returns the list of titles for a specified bill.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/billType'
- $ref: '#/components/parameters/billNumber'
- $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/Titles'
application/xml:
schema:
$ref: '#/components/schemas/Titles'
'400':
description: Invalid status value
/law/{congress}:
get:
tags:
- bill
summary: Returns a list of laws filtered by the specified congress.
description: Returns a list of laws filtered by the specified congress.
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/Law'
application/xml:
schema:
$ref: '#/components/schemas/Law'
'400':
description: Invalid status value
/law/{congress}/{lawType}:
get:
tags:
- bill
summary: Returns a list of laws filtered by specified congress and law type (public or private).
description: Returns a list of laws filtered by specified congress and law type (public or private).
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/lawType'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/Law'
application/xml:
schema:
$ref: '#/components/schemas/Law'
'400':
description: Invalid status value
/law/{congress}/{lawType}/{lawNumber}:
get:
tags:
- bill
summary: Returns a law filtered by specified congress, law type (public or private), and law number.
description: Returns a law filtered by specified congress, law type (public or private), and law number.
parameters:
- $ref: '#/components/parameters/congress'
- $ref: '#/components/parameters/lawType'
- $ref: '#/components/parameters/lawNumber'
- $ref: '#/components/parameters/format'
- $ref: '#/components/parameters/offset'
- $ref: '#/components/parameters/limit'
responses:
'200':
description: Successful operation
content:
application/json:
schema:
$ref: '#/components/schemas/LawNumber'
application/xml:
schema:
$ref: '#/components/schemas/LawNumber'
'400':
description: Invalid status value
components:
schemas:
BillSummaries:
type: array
items:
$ref: '#/components/schemas/billSummariesArray'
cboCost:
type: object
properties:
description:
type: string
example: 'As ordered reported by the House Committee on Oversight and Accountability on September 20, 2023
'
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
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
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
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
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>
[Congressional Record Volume 169, Number 130 (Thursday, July 27, 2023)]
[House]
[Pages H4143-H4144]
From the Congressional Record Online through the Government Publishing Office [<a href="https://www.gpo.gov">www.gpo.gov</a>]
By Mr. COMER:
H.R. 4984.
Congress has the power to enact this legislation pursuant
to the following:
Article I, Section 8, Clause 17 of the U.S. Constitution,
in that the legislation ``to exercise exclusive Legislation
in all Cases
[[Page H4144]]
whatsoever, over such District (not exceeding ten Miles
square) as may, by Cession of particular States, and the
Acceptance of Congress, become the Seat of the Government of
the United States, and to exercise like Authority over all
Places purchased by the Consent of the Legislature of the
State in which the Same shall be, for the Erection of Forts,
Magazines, Arsenals, dock-Yards, and other needful
Buildings.''''
The single subject of this legislation is:
To transfer administrative jurisdiction of the District of
Columbia RFK Memorial Stadium campus from the Secretary of
the Interior to the Administrator of General Services and
authorize a new lease with D.C. for redevelopment.
</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'
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
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
policyArea:
type: object
properties:
name:
type: string
example: Government Operations and Politics
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
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
Text:
type: array
items:
$ref: '#/components/schemas/textVersions'
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
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'
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'
Titles:
type: array
items:
$ref: '#/components/schemas/titlesArray'
relationshipDetails:
type: object
properties:
identifiedBy:
type: string
example: CRS
type:
type: string
example: Related Bill
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
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: h
# --- truncated at 32 KB (35 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/loc/refs/heads/main/openapi/loc-bill-api-openapi.yml