# Congress.gov API: Get bill > Gets the status, official summary, titles, actions and related bills for one U.S. bill on Congress.gov, found by popular name, title, number or link. A missing summary or text is returned as null. Unofficial. Not affiliated with or endorsed by Congress.gov. - Page: https://fous.com/methods/congress.gov/get-bill - Method: `congress.gov/get_bill`, version 1 - Website: congress.gov - Returns: bill number, titles, congress, sponsor, cosponsor count, status, policy area, summary, actions, related bills, latest text link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `bill` | string | yes | `"H.R. 4346"` | Popular name, title, number or Congress.gov bill link, for example CHIPS and Science Act. | | `congress` | integer | no | `117` | Congress number or calendar year, for example 117 or 2022. Defaults to the most recent matching bill; a bare number uses the current Congress. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "bill": "H.R. 4346", "congress": 117 } ``` Its output: ```json { "link": "https://www.congress.gov/bill/117th-congress/house-bill/4346", "status": "Became law - Public Law 117-167", "actions": [ { "date": "2022-08-09", "text": "Became Public Law No: 117-167." }, { "date": "2022-08-09", "text": "Signed by President." }, { "date": "2022-08-02", "text": "Presented to President." } ], "sponsor": "Rep. Ryan, Tim [D-OH-13]", "summary": "This act provides funds to support the domestic production of semiconductors and authorizes various programs and activities of the federal science agencies.\n\nDIVISION A--CHIPS ACT OF 2022\n\nCHIPS Act of 2022\n\n(Sec. 102) The act establishes and provides funding for the Creating Helpful Incentives to P…", "congress": 117, "bill_number": "H.R.4346", "policy_area": "Science, Technology, Communications", "short_title": "CHIPS and Science Act", "related_bills": [ { "link": "https://www.congress.gov/bill/117th-congress/house-bill/2471", "title": "Consolidated Appropriations Act, 2022", "bill_number": "H.R.2471" }, { "link": "https://www.congress.gov/bill/117th-congress/house-bill/4222", "title": "Capitol Police Retirement Reform Act of 2021", "bill_number": "H.R.4222" }, { "link": "https://www.congress.gov/bill/117th-congress/house-bill/4819", "title": "National Nuclear University Research Infrastructure Reinvestment Act of 2021", "bill_number": "H.R.4819" } ], "sponsor_party": "Democratic", "sponsor_state": "OH", "official_title": "Making appropriations for Legislative Branch for the fiscal year ending September 30, 2022, and for other purposes.", "cosponsor_count": 0, "introduced_date": "2021-07-01", "latest_text_link": "https://www.congress.gov/bill/117th-congress/house-bill/4346/text/statute?statuteId=48173" } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"congress.gov/get_bill","input":{"bill":"H.R. 4346","congress":117}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What's the current status of the Inflation Reduction Act and who sponsored it? - Pull up H.R. 3684 from the 117th Congress on congress.gov — I need the official summary and the full list of actions. - Find the Laken Riley Act and tell me how many cosponsors it has and what related bills exist. - I need the policy area, titles, and latest text link for S. 2226 introduced in 2023. - Look up https://www.congress.gov/bill/118th-congress/house-bill/2 on congress.gov and summarize where it stands. ## Input schema ```json { "type": "object", "required": [ "bill" ], "properties": { "bill": { "type": "string", "description": "Popular name, title, number or Congress.gov bill link, for example CHIPS and Science Act." }, "congress": { "type": "integer", "description": "Congress number or calendar year, for example 117 or 2022. Defaults to the most recent matching bill; a bare number uses the current Congress." } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "bill_number", "short_title", "official_title", "congress", "sponsor", "sponsor_party", "sponsor_state", "cosponsor_count", "introduced_date", "status", "policy_area", "summary", "actions", "related_bills", "latest_text_link", "link" ], "properties": { "link": { "type": "string" }, "status": { "type": "string" }, "actions": { "type": "array", "items": { "type": "object", "required": [ "date", "text" ], "properties": { "date": { "type": "string" }, "text": { "type": "string" } }, "additionalProperties": false } }, "sponsor": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "congress": { "type": "integer" }, "bill_number": { "type": "string" }, "policy_area": { "type": [ "string", "null" ] }, "short_title": { "type": [ "string", "null" ] }, "related_bills": { "type": "array", "items": { "type": "object", "required": [ "bill_number", "title", "link" ], "properties": { "link": { "type": "string" }, "title": { "type": "string" }, "bill_number": { "type": "string" } }, "additionalProperties": false } }, "sponsor_party": { "type": [ "string", "null" ] }, "sponsor_state": { "type": [ "string", "null" ] }, "official_title": { "type": [ "string", "null" ] }, "cosponsor_count": { "type": [ "integer", "null" ] }, "introduced_date": { "type": [ "string", "null" ] }, "latest_text_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } ``` ## See more - [legislation.gov.uk API: Get UK law section](https://fous.com/methods/legislation.gov.uk/get-law-section.md): Gets the latest available revised text of a section of a UK Act from legislation.gov.uk, or the Act's section contents when no section is given. The outstanding-changes flag describes the Act and may include changes outside the selected section. - [legislation.gov.uk API: Search UK legislation](https://fous.com/methods/legislation.gov.uk/search-legislation.md): Search UK legislation by topic or title, with optional type and year filters. Closest title matches appear first; broader text matches fill remaining places. - [NPR API: Read article](https://fous.com/methods/npr.org/read-article.md): Reads an NPR article by its link or headline and returns its text and publication details. For live blogs, returns the displayed updates. - [Semantic Scholar API: Get paper details](https://fous.com/methods/semanticscholar.org/get-paper.md): Finds a paper on Semantic Scholar by title, DOI or Semantic Scholar link and returns its abstract, one-sentence summary, authors, publication details, citation counts and a free PDF link when there is one. - [AP News API: Read article](https://fous.com/methods/apnews.com/read-article.md): Reads the full text and details of one public AP News article from its link or headline. - [CNN API: Read an article](https://fous.com/methods/cnn.com/read-article.md): Reads a CNN article by link or headline and returns its headline, summary, authors, dates, section, tags, main image and public paragraphs. Subscriber stories return only a brief public preview; live blogs include their entries. - [BBC News API: Read article](https://fous.com/methods/bbc.com/read-article.md): Reads the text and details of a BBC News article from its link or headline. Live coverage pages return the latest entries available. - [Grants.gov API: Search grant opportunities](https://fous.com/methods/grants.gov/search-grants.md): Finds U.S. federal grant opportunities by topic, agency, applicant type and status, with funding and eligibility details. Open results exclude opportunities whose closing date has passed.