gc_list_bill_amendments

List a bill's amendments

Every amendment offered to a bill, newest first: purpose, author, latest action, and whether its text is mirrored. This is a metadata list; read a mirrored full text with gc_get_amendment_text. Congress publishes amendment text as Congressional Record pages, so it is plain text rather than Markdown.

Input

Parameter	Type	Description
idRequired	string	Bill key "congress/type/number", e.g. "119/hr/3076".
cursor	string	Next page of amendments.
limit	integer	Amendments per page (default 20).

Annotations

{
  "readOnlyHint": true,
  "openWorldHint": false
}

Examples

Every amendment to a bill

The complete paged metadata list behind the bill getter's preview, with a route to each mirrored full text.

{
  "id": "119/hr/3076"
}

{
  "type": "bill_amendments",
  "bill": "119/hr/3076",
  "items": [
    {
      "id": "119/samdt/3",
      "purpose": "Purpose of amendment 3",
      "author": null,
      "submitted": "2026-04-02",
      "latest_action": null,
      "latest_action_date": null,
      "has_text": true,
      "text_via": "gc_get_amendment_text"
    },
    {
      "id": "119/samdt/2",
      "purpose": "Purpose of amendment 2",
      "author": null,
      "submitted": "2026-04-01",
      "latest_action": null,
      "latest_action_date": null,
      "has_text": false
    }
  ],
  "total": 3,
  "next_cursor": "eyJmIjoiNDExMjY5MDgiLCJwIjp7InN0YXJ0IjoyfX0",
  "details_via": "gc_get_amendment",
  "text_via": "gc_get_amendment_text",
  "source": "congress.gov",
  "links": {
    "governmentcontext": "https://governmentcontext.com/bills/119/hr/3076"
  }
}