{"openapi":"3.1.0","info":{"title":"Bill100 API","version":"1.0.0","description":"Bill100 is the open, agent-readable index of U.S. legislation. Search every federal bill, read a plain-English AI summary of what it does, and track the ones that matter with same-day alerts. The same live data is a public JSON API and an MCP server, so AI agents can look up a bill's status, sponsors and impact the way a policy analyst would. Free to start — built for public-affairs teams, associations, journalists, and the agents building on top of them.","contact":{"name":"Bill100","url":"https://www.bill100.com","email":"hello@bill100.com"}},"servers":[{"url":"https://www.bill100.com"}],"security":[{},{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"bill100_live_*"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}},"Bill":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}},"Legislator":{"type":"object","properties":{"bioguide":{"type":"string"},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"district":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}}}},"paths":{"/api/v1/bills":{"get":{"summary":"Search and list U.S. federal bills by keyword, congress, status, policy area, sponsor or chamber.","operationId":"get_api_v1_bills","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Full-text query (title + summary), e.g. \"artificial intelligence\".","schema":{"type":"string"}},{"name":"congress","in":"query","required":false,"description":"Congress number, e.g. 119.","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"introduced | in_committee | passed_house | passed_senate | to_president | enacted | failed | vetoed.","schema":{"type":"string"}},{"name":"policy_area","in":"query","required":false,"description":"Congress.gov policy area, e.g. \"Health\".","schema":{"type":"string"}},{"name":"sponsor","in":"query","required":false,"description":"Sponsor Bioguide id, e.g. F000477.","schema":{"type":"string"}},{"name":"chamber","in":"query","required":false,"description":"house | senate.","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"recent (default) | introduced | relevance.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"1–100 (default 20).","schema":{"type":"string"}},{"name":"offset","in":"query","required":false,"description":"Pagination offset.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"count":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"},"bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}}},"request_id":{"type":"string"}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}}}},"/api/v1/bills/{id}":{"get":{"summary":"Get one bill by id (e.g. 119-hr-1234) with its status, sponsors, action timeline and sources.","operationId":"get_api_v1_bills_id","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"bill":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}},"request_id":{"type":"string"}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}}}},"/api/v1/bills/{id}/summary":{"get":{"summary":"Plain-English AI summary of what a bill does, who it affects and where it is in the process (cached).","operationId":"get_api_v1_bills_id_summary","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Bill id, e.g. 119-hr-1234.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"bill":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}},"summary":{"type":"string"},"generated_at":{"type":"string","nullable":true},"request_id":{"type":"string"}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}}}},"/api/v1/bills/{id}/analyze":{"post":{"summary":"Tailored AI impact analysis: how a bill affects a specific business/industry context. Metered (Pro/Scale).","operationId":"post_api_v1_bills_id_analyze","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Bill id, e.g. 119-hr-1234.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"bill":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}},"context":{"type":"string"},"analysis":{"type":"string"},"model":{"type":"string"},"request_id":{"type":"string"}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["context"],"properties":{"context":{"type":"string","description":"Describe your organization/industry to tailor the analysis."}}}}}}}},"/api/v1/legislators/{id}":{"get":{"summary":"Get a member of Congress by Bioguide id, with the bills they have sponsored.","operationId":"get_api_v1_legislators_id","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"Bioguide id, e.g. F000477.","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"legislator":{"type":"object","properties":{"bioguide":{"type":"string"},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"district":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"}}},"sponsored_count":{"type":"integer"},"sponsored_bills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Bill id: <congress>-<type>-<number>, e.g. 119-hr-1234."},"citation":{"type":"string","example":"H.R. 1234"},"congress":{"type":"integer"},"bill_type":{"type":"string"},"number":{"type":"integer"},"title":{"type":"string"},"short_title":{"type":"string","nullable":true},"chamber":{"type":"string","nullable":true},"status":{"type":"string","enum":["introduced","in_committee","passed_house","passed_senate","to_president","enacted","failed","vetoed"]},"status_label":{"type":"string"},"status_step":{"type":"integer"},"is_enacted":{"type":"boolean"},"introduced_date":{"type":"string","format":"date","nullable":true},"latest_action":{"type":"string","nullable":true},"latest_action_date":{"type":"string","format":"date","nullable":true},"sponsor":{"type":"object","properties":{"bioguide":{"type":"string","nullable":true},"name":{"type":"string"},"party":{"type":"string","nullable":true},"state":{"type":"string","nullable":true}},"nullable":true},"cosponsor_count":{"type":"integer"},"policy_area":{"type":"string","nullable":true},"subjects":{"type":"array","items":{"type":"string"}},"official_summary":{"type":"string","nullable":true},"ai_summary":{"type":"string","nullable":true},"url":{"type":"string","format":"uri"},"sources":{"type":"object","properties":{"congress_gov":{"type":"string","nullable":true},"govtrack":{"type":"string","nullable":true}}}}}}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}}}},"/api/v1/pricing":{"get":{"summary":"Machine-readable pricing — plans, included API calls, per-call overage, rate limits and features.","operationId":"get_api_v1_pricing","security":[{},{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string"},"plans":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Upgrade required (paid feature)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"429":{"description":"Rate limited","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}},"502":{"description":"Upstream data source unavailable","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"]},"request_id":{"type":"string"}}}}}}}}}}}