amendments

Get and filter lists of Congressional Amendments.

Examples

from openbb import obb
obb.uscongress.amendments()
obb.uscongress.amendments(congress=119, amendment_type='hamdt')

Parameters

• standard
• congress_gov

congress: int | None
Congress number (e.g., 119 for the 119th Congress). When None, returns amendments across all congresses (requires amendment_type).

amendment_type: str | None

Description

Amendment type (e.g., 'hamdt' for House Amendments).

Must be one of:

• hamdt: An amendment offered or adopted in the House of Representatives.
  House amendments are identified by 'H.Amdt.' followed by a number.
  
• samdt: An amendment offered or adopted in the Senate.
  Senate amendments are identified by 'S.Amdt.' followed by a number.
  
• suamdt: A Senate amendment that was submitted but not subsequently amended.
  

start_date: date | None | str
Filter amendments updated on or after this date.

end_date: date | None | str
Filter amendments updated on or before this date.

limit: int | None
Maximum number of results to return. When None, defaults to 100 (max 250). Set to 0 for no limit (must be used with 'amendment_type').

offset: int | None
The starting record returned. 0 is the first record.

sort_by: Literal['asc', 'desc'] | None
Default: desc
Sort by update date. Default is latest first.

---

Returns

results: CongressAmendments

Serializable results.

provider: Optional[Literal['congress_gov']]

Provider name.

warnings: Optional[list[Warning_]]

list of warnings.

chart: Optional[Chart]

Chart object.

extra: dict[str, Any]

Extra info.

---

Data

• standard
• congress_gov

congress: int
The congress session number.

amendment_type: str
The type of amendment (e.g., HAMDT, SAMDT).

number: str
The amendment number.

amended_bill: str | None
The bill being amended (e.g., 'HR 1234' or 'S 456').

amended_bill_title: str | None
The title of the bill being amended.

description: str | None
A short description of the amendment.

purpose: str | None
The purpose of the amendment.

latest_action_date: date | None
The date of the latest action.

latest_action: str | None
Latest action text.

latest_action_time: str | None
The time of the latest action.

sponsor: str | None
The primary sponsor of the amendment.

submitted_date: date | None
The date the amendment was submitted.

update_date: date | None
The date the record was last updated.

amendment_url: str
Base URL to the amendment for the congress.gov API.