Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. By signing up you are subscribing to the APIs.io and API Evangelist
newsletters — you can unsubscribe from any issue. See our
Privacy Policy and Terms.
openapi: 3.2.0
info:
title: KeyVex Member Profile API
version: 0.102.0
termsOfService: https://keyvex.com/terms
description: 'US public financial-disclosure data — congressional trades, insider filings (Form 4), lobbying, Treasury auctions, member profiles. Requires an API key — create a free one at https://keyvex.com and send it as the header `x-api-key: `. A free key returns most public-record datasets (one year of history; no market-price data and a few heavy datasets are on paid plans only), capped at 60 requests/day; paid plans raise the caps. The daily allowance resets at midnight Eastern.'
servers:
- url: https://api.keyvex.com
security:
- ApiKeyAuth: []
tags:
- name: Member Profile
paths:
/v1/member-profile:
get:
operationId: get_member_profile
summary: Returns Congressional member profiles from the unitedstates/…
description: '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.'
parameters:
- name: bioguide_id
in: query
required: false
description: Permanent member identifier — letter + 6 digits (e.g., 'C001035' for Susan Collins, 'P000197' for Nancy Pelosi). Direct doc lookup, fastest path.
schema:
type: string
- name: member_name
in: query
required: false
description: 'Case-insensitive substring against full_name. Example: ''Pelosi'' returns Nancy Pelosi.'
schema:
type: string
- name: state
in: query
required: false
description: 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.
schema:
type: string
- name: chamber
in: query
required: false
description: Filter to House Representatives or Senators.
schema:
type: string
enum:
- house
- senate
- name: party
in: query
required: false
description: '''Democrat'' | ''Republican'' | ''Independent'' | etc. Exact match — uses the YAML''s spelling.'
schema:
type: string
- name: committee_id
in: query
required: false
description: Thomas committee code (full committee like 'HSAS' or subcommittee like 'HSAG15'). Returns all members of that committee.
schema:
type: string
- name: limit
in: query
required: false
description: Maximum records to return. Default 50, max 600 (~current Congress size).
schema:
type: integer
responses:
'200':
description: 'JSON envelope: { results: [...], count, has_more }.'
'400':
description: Invalid parameter.
'401':
description: Missing or invalid API key.
'402':
description: This tool requires a higher plan (upgrade_required). Retrying will not help.
'429':
description: Tier rate/quota limit reached (rate_limited). Retry-After points at the reset.
tags:
- Member Profile
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key