{"uid":"cap_j0j8Gg2M_N9igJsJCFM3C","slug":"2s-io-fe5909a6","name":"2s.io Congress Bill Lookup","description":"Look up or search US Congressional bills via the Library of Congress Congress.gov API. Pass congress + type + number to fetch a specific bill (title, sponsors, latest action, action/amendment/committee counts, policy area, congress.gov URL). Or omit number to list bills filtered by congress, bill type (hr | s | hjres | sjres | hconres | sconres | hres | sres), date range, with pagination + sort. Bill type semantics: hr=House Bill, s=Senate Bill, hjres/sjres=joint resolution, hconres/sconres=concurrent resolution, hres/sres=simple resolution.","url":"https://2s.io/api/gov/congress-bill","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"properties":{"sort":{"enum":["updateDate+desc","updateDate+asc"],"type":"string","default":"updateDate+desc"},"type":{"enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"type":"string"},"limit":{"type":"integer","default":20,"maximum":250,"minimum":1},"number":{"type":"integer","description":"Bill number. Omit to list."},"offset":{"type":"integer","default":0,"minimum":0},"toDate":{"type":"string"},"congress":{"type":"integer","minimum":1,"description":"Congress number, e.g. 119 for 2025-2027."},"fromDate":{"type":"string","description":"ISO date YYYY-MM-DD, listing only."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"type":"hr","limit":10,"congress":119}}},"response":{"data":{"ok":true,"meta":{"mode":"list"},"items":[{"type":"HR","title":"Reserved for the Speaker.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/6?format=json","number":"6","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Reserved for the Speaker.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/9?format=json","number":"9","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Reserved for the Minority Leader.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/11?format=json","number":"11","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Reserved for the Minority Leader.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/13?format=json","number":"13","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Reserved for the Minority Leader.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/16?format=json","number":"16","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Reserved for the Minority Leader.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/19?format=json","number":"19","congress":119,"updateDate":"2025-01-14","latestAction":null,"originChamber":"House"},{"type":"HR","title":"Small Business Prosperity Act of 2025","apiUrl":"https://api.congress.gov/v3/bill/119/hr/110?format=json","number":"110","congress":119,"updateDate":"2025-01-31","latestAction":{"text":"Referred to the House Committee on Ways and Means.","actionDate":"2025-01-03"},"originChamber":"House"},{"type":"HR","title":"To repeal the National Voter Registration Act of 1993.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/55?format=json","number":"55","congress":119,"updateDate":"2025-02-03","latestAction":{"text":"Referred to the House Committee on House Administration.","actionDate":"2025-01-03"},"originChamber":"House"},{"type":"HR","title":"Improving Science in Chemical Assessments Act","apiUrl":"https://api.congress.gov/v3/bill/119/hr/123?format=json","number":"123","congress":119,"updateDate":"2025-02-03","latestAction":{"text":"Referred to the Committee on Science, Space, and Technology, and in addition to the Committee on Energy and Commerce, for a period to be subsequently determined by the Speaker, in each case for consideration of such provisions as fall within the jurisdiction of the committee concerned.","actionDate":"2025-01-03"},"originChamber":"House"},{"type":"HR","title":"To terminate the designation of the Islamic Republic of Pakistan as a major non-NATO ally, and for other purposes.","apiUrl":"https://api.congress.gov/v3/bill/119/hr/94?format=json","number":"94","congress":119,"updateDate":"2025-02-04","latestAction":{"text":"Referred to the House Committee on Foreign Affairs.","actionDate":"2025-01-03"},"originChamber":"House"}],"total":9256,"source":{"url":"https://api.congress.gov/","license":"Public domain (US government work)","provider":"Congress.gov API (Library of Congress)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"gov.congress-bill","settlement":{"txHash":"0xba42be2e4bd382fe3afe565eaa10962dccf3c2e4bceced5b288c96215c1bc920","network":"eip155:8453","success":true}}}},"exampleRequest":{"type":"hr","limit":10,"congress":119},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OXBtBpO0mGij93ogpq0iW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Look up or search US Congressional bills via the Library of Congress Congress.gov API, returning bill metadata like title, sponsors, latest action, and policy area","exampleAgentPrompt":"Can you pull up the details on House Bill 1234 from the 119th Congress — I want the title, sponsors, latest action, and what policy area it falls under?","exampleUseCases":null,"resultDescription":"Returns bill metadata including title, sponsor information, latest action taken, counts of actions/amendments/committees, policy area classification, and a direct congress.gov URL. When listing (no bill number), returns a paginated array of bills filtered by congress, type, and optional date range.","failureModes":["Invalid or non-existent bill number returns empty result or 404","Unsupported bill type enum value returns validation error","Congress number out of historical range returns no results","fromDate/toDate in wrong format causes parsing error","Rate limit or payment failure (x402) blocks the request","Offset beyond total results returns empty list"],"whenToPreferThis":"Use this endpoint when you need authoritative, structured US Congressional bill data sourced directly from the Library of Congress. Prefer it over web scraping or general search when you need specific bill metadata (sponsors, actions, amendments, committee counts, policy area) for a known bill or want to enumerate bills filtered by type, congress session, and date range with reliable pagination.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:20.688Z","isFirstParty":false}