{"openapi":"3.1.0","info":{"title":"Congress.gov (BYOK) API","version":"0.1.0","description":"Congress.gov (BYOK) lets an AI assistant read your own Congress.gov data through the Congress.gov API with a key you supply (api.data.gov API key for Congress.gov). Read-only: 11 tools (list_recent_bills, list_bills_by_type, get_bill, list_bill_actions, list_bill_cosponsors, get_bill_summaries, list_amendments, list_members, get_member, list_member_sponsored_bills, list_committees). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-congress.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-congress/docs"},"termsOfService":"https://connectorbay.com/byok-congress/terms"},"servers":[{"url":"https://byok-congress.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-congress/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_recent_bills":{"post":{"operationId":"list_recent_bills","summary":"List bills and resolutions across all Congresses, ordered by date of latest action, with type, number, title, chamber an","description":"List bills and resolutions across all Congresses, ordered by date of latest action, with type, number, title, chamber and latest action. Optionally limit by update time. Use for \"What bills in Congress had action most recently\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"from_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or after this time, format YYYY-MM-DDT00:00:00Z.","title":"From Date Time"},"to_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or before this time, format YYYY-MM-DDT00:00:00Z.","title":"To Date Time"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"title":"list_recent_billsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_bills_by_type":{"post":{"operationId":"list_bills_by_type","summary":"List the bills of one type (for example hr or s) in one Congress, with number, title, origin chamber and latest action. ","description":"List the bills of one type (for example hr or s) in one Congress, with number, title, origin chamber and latest action. Use for \"List the Senate bills (type s) of the 119th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"bill_type":{"description":"Bill type: hr, s, hjres, sjres, hconres, sconres, hres or sres.","enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"title":"Bill Type","type":"string"},"from_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or after this time, format YYYY-MM-DDT00:00:00Z.","title":"From Date Time"},"to_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or before this time, format YYYY-MM-DDT00:00:00Z.","title":"To Date Time"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","bill_type"],"title":"list_bills_by_typeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_bill":{"post":{"operationId":"get_bill","summary":"Get one bill: title, sponsors, introduced date, origin chamber, policy area, latest action and the counts of actions, co","description":"Get one bill: title, sponsors, introduced date, origin chamber, policy area, latest action and the counts of actions, committees, cosponsors and amendments. Use for \"Show details of H.R. 3076 in the 117th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"bill_type":{"description":"Bill type: hr, s, hjres, sjres, hconres, sconres, hres or sres.","enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"title":"Bill Type","type":"string"},"bill_number":{"description":"The bill's assigned number, for example 3076.","maximum":100000,"minimum":1,"title":"Bill Number","type":"integer"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","bill_type","bill_number"],"title":"get_billArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_bill_actions":{"post":{"operationId":"list_bill_actions","summary":"List the legislative actions taken on a bill (introduced, referred, passed, signed ...) with date, text and type. Use fo","description":"List the legislative actions taken on a bill (introduced, referred, passed, signed ...) with date, text and type. Use for \"What actions have been taken on H.R. 3076 of the 117th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"bill_type":{"description":"Bill type: hr, s, hjres, sjres, hconres, sconres, hres or sres.","enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"title":"Bill Type","type":"string"},"bill_number":{"description":"The bill's assigned number, for example 3076.","maximum":100000,"minimum":1,"title":"Bill Number","type":"integer"},"from_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or after this time, format YYYY-MM-DDT00:00:00Z.","title":"From Date Time"},"to_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or before this time, format YYYY-MM-DDT00:00:00Z.","title":"To Date Time"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","bill_type","bill_number"],"title":"list_bill_actionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_bill_cosponsors":{"post":{"operationId":"list_bill_cosponsors","summary":"List the cosponsors of a bill with name, party, state, district, sponsorship date and whether they were an original cosp","description":"List the cosponsors of a bill with name, party, state, district, sponsorship date and whether they were an original cosponsor. Use for \"Who cosponsored S. 3580 in the 117th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"bill_type":{"description":"Bill type: hr, s, hjres, sjres, hconres, sconres, hres or sres.","enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"title":"Bill Type","type":"string"},"bill_number":{"description":"The bill's assigned number, for example 3076.","maximum":100000,"minimum":1,"title":"Bill Number","type":"integer"},"sort":{"anyOf":[{"enum":["updateDate+asc","updateDate+desc"],"type":"string"},{"type":"null"}],"default":null,"description":"Order by update date: updateDate+asc or updateDate+desc.","title":"Sort"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","bill_type","bill_number"],"title":"list_bill_cosponsorsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_bill_summaries":{"post":{"operationId":"get_bill_summaries","summary":"List the Congressional Research Service summaries of a bill, one per version, with action date, description and summary ","description":"List the Congressional Research Service summaries of a bill, one per version, with action date, description and summary text (HTML). Use for \"Summarize H.R. 3076 of the 117th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"bill_type":{"description":"Bill type: hr, s, hjres, sjres, hconres, sconres, hres or sres.","enum":["hr","s","hjres","sjres","hconres","sconres","hres","sres"],"title":"Bill Type","type":"string"},"bill_number":{"description":"The bill's assigned number, for example 3076.","maximum":100000,"minimum":1,"title":"Bill Number","type":"integer"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","bill_type","bill_number"],"title":"get_bill_summariesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_amendments":{"post":{"operationId":"list_amendments","summary":"List amendments filed in one Congress, with type, number, purpose and latest action. Use for \"Which amendments were file","description":"List amendments filed in one Congress, with type, number, purpose and latest action. Use for \"Which amendments were filed in the 119th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"from_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or after this time, format YYYY-MM-DDT00:00:00Z.","title":"From Date Time"},"to_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or before this time, format YYYY-MM-DDT00:00:00Z.","title":"To Date Time"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress"],"title":"list_amendmentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_members":{"post":{"operationId":"list_members","summary":"List members of Congress with Bioguide id, name, party, state, district and terms of service. Set current_member to true","description":"List members of Congress with Bioguide id, name, party, state, district and terms of service. Set current_member to true for sitting members only. Use for \"Which members of Congress are currently serving\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"current_member":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"True for current members only, false for former members; omit for all.","title":"Current Member"},"from_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or after this time, format YYYY-MM-DDT00:00:00Z.","title":"From Date Time"},"to_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only items updated at or before this time, format YYYY-MM-DDT00:00:00Z.","title":"To Date Time"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"title":"list_membersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_member":{"post":{"operationId":"get_member","summary":"Get one member of Congress by Bioguide id: name, birth year, party history, terms served and counts of sponsored and cos","description":"Get one member of Congress by Bioguide id: name, birth year, party history, terms served and counts of sponsored and cosponsored bills. Use for \"Give me the profile of the member with Bioguide id L000174\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"bioguide_id":{"description":"Member's Bioguide identifier, for example L000174.","maxLength":20,"title":"Bioguide Id","type":"string"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["bioguide_id"],"title":"get_memberArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_member_sponsored_bills":{"post":{"operationId":"list_member_sponsored_bills","summary":"List the bills and resolutions a member sponsored, with Congress, number, title, introduced date, policy area and latest","description":"List the bills and resolutions a member sponsored, with Congress, number, title, introduced date, policy area and latest action. Use for \"What bills did L000174 sponsor\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"bioguide_id":{"description":"Member's Bioguide identifier, for example L000174.","maxLength":20,"title":"Bioguide Id","type":"string"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["bioguide_id"],"title":"list_member_sponsored_billsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_committees":{"post":{"operationId":"list_committees","summary":"List the committees and subcommittees of one chamber in one Congress, with system code, name, type and parent committee.","description":"List the committees and subcommittees of one chamber in one Congress, with system code, name, type and parent committee. Use for \"List the House committees of the 119th Congress\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"congress":{"description":"Congress number, for example 119 for the Congress that began in January 2025.","maximum":200,"minimum":1,"title":"Congress","type":"integer"},"chamber":{"description":"Chamber: house, senate or joint.","enum":["house","senate","joint"],"title":"Chamber","type":"string"},"limit":{"anyOf":[{"maximum":250,"minimum":1,"type":"integer"},{"type":"null"}],"default":20,"description":"How many records to return (1 to 250).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of records to skip; 0 starts at the first record.","title":"Offset"},"format":{"anyOf":[{"const":"json","type":"string"},{"type":"null"}],"default":"json","description":"Response format. Only json is offered here.","title":"Format"}},"required":["congress","chamber"],"title":"list_committeesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}