Returns Congressional member profiles from the unitedstates/ congress-legislators catalog

Returns Congressional member profiles from the unitedstates/ congress-legislators catalog. Each record is one current House Representative or Senator, keyed by bioguide_id (the permanent member identifier — e.g., 'C001035' for Susan Collins). Use this when the user asks about: which committees a member sits on, who chairs the Senate Banking Committee, all Republicans on House Armed Services, party/state/district lookup for a specific member, or to enrich congressional_trades records with member context (party + state + committee assignments). Filter by bioguide_id for a direct fetch; by member_name for a case-insensitive substring search; by committee_id (e.g., 'HSAS' for House Armed Services, 'SSAF' for Senate Agriculture, 'HSAG15' for the Forestry & Horticulture subcommittee under House Ag) to find all members of a committee. Combine state + chamber + party for caucus-level queries. Committee codes follow the Library of Congress 'Thomas' convention: House full committees: HSAG (Agriculture), HSAS (Armed Services), HSAP (Appropriations), HSBA (Financial Services), HSED (Education), HSEN (Energy & Commerce), HSII (Natural Resources), HSJU (Judiciary), HSWM (Ways and Means), etc. Senate full committees: SSAF (Ag), SSAS (Armed Services), SSAP (Appropriations), SSBK (Banking), SSCM (Commerce), SSEG (Energy), SSFI (Finance), SSHR (HELP), SSJU (Judiciary), etc. Subcommittees append the subcommittee thomas_id: HSAG15, HSBA00. Photo URLs are constructed (theunitedstates.io/images/congress/ original/{bioguide_id}.jpg) but Cloudflare-protected — clients fetch directly. Senate class field (1/2/3) on senators only.

get/v1/member-profile

Request

  • Base URL: https://api.keyvex.com
  • URL: https://api.keyvex.com/v1/member-profile
  • Auth: API key in header x-api-key

Query parameters

bioguide_idstring

Permanent member identifier — letter + 6 digits (e.g., 'C001035' for Susan Collins, 'P000197' for Nancy Pelosi). Direct doc lookup, fastest path.

member_namestring

Case-insensitive substring against full_name. Example: 'Pelosi' returns Nancy Pelosi.

statestring

2-letter state abbreviation (e.g., 'ME', 'CA'). Filters to members from that state — useful with chamber=senate to get the 2 senators from a state.

chamber'house' | 'senate'

Filter to House Representatives or Senators.

partystring

'Democrat' | 'Republican' | 'Independent' | etc. Exact match — uses the YAML's spelling.

committee_idstring

Thomas committee code (full committee like 'HSAS' or subcommittee like 'HSAG15'). Returns all members of that committee.

limitinteger

Maximum records to return. Default 50, max 600 (~current Congress size).

Response

JSON envelope: { results: [...], count, has_more }.

Changes

No recorded changes to this operation across all 1 revision of this API.