KeyVex Fec Candidate Profile API

The Fec Candidate Profile API from KeyVex — 1 operation(s) for fec candidate profile.

GitHub OpenAPI

Operations 1

GET /v1/fec-candidate-profile Returns FEC-registered candidate profiles (House, Senate, President) and — when… #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-fec-candidate-profile-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

keyvex-com-fec-candidate-profile-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: KeyVex Fec Candidate 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: Fec Candidate Profile
paths:
  /v1/fec-candidate-profile:
    get:
      operationId: get_fec_candidate_profile
      summary: Returns FEC-registered candidate profiles (House, Senate, President) and — when…
      description: 'Returns FEC-registered candidate profiles (House, Senate, President) and — when include_committees=true (default) — each candidate''s associated FEC committees in the same response. Use this when the user asks about: who''s running in race X, the campaign finance ID for a member, what PAC is sponsoring a candidate, or to bridge from a Congressional member name to their FEC committee_id before looking up contributions (v1.1 tool). Source: api.open.fec.gov — the official Federal Election Commission public-disclosure API. Records include current sitting members, primary challengers, defeated candidates, future-cycle registrants, and presidential candidates. Cycles tracked: 2022, 2024, 2026. Filter by candidate_id for the fastest direct lookup. Otherwise use candidate_name (case-insensitive substring) optionally narrowed by office + state + cycle. FEC names are typically filed as LASTNAME, FIRSTNAME (e.g., ''MCCORMICK, DAVE'' for Dave McCormick). Office codes: H (House), S (Senate), P (President). Party codes: DEM (Democratic), REP (Republican), LIB (Libertarian), GRE (Green), IND (Independent), OTH (Other). Incumbent_challenge: I (Incumbent), C (Challenger), O (Open seat). When active_only=true, only candidates with candidate_status=''C'' (currently filing) are returned. Committee designations on returned committees: P (Principal campaign committee — the primary donation recipient), A (Authorized — accepts donations on candidate''s behalf), B (Lobbyist), D (Leadership PAC), J (Joint fundraiser), U (Unauthorized). The Principal (P) committee is the one you want for ''donations to X''s campaign''. Committee types: H (House campaign), S (Senate campaign), P (Presidential campaign), Q (PAC qualified), N (PAC non-qualified), O (Super PAC), I (Independent expenditure non-PAC), X/Y/Z (Party), V/W (Carey/hybrid). For ''follow the money to Senator X'', look for designation=P, committee_type=S among the returned committees.'
      parameters:
      - name: candidate_id
        in: query
        required: false
        description: FEC-assigned candidate ID (immutable across cycles), e.g., 'S6PA00091' for Pat Toomey, 'P80003338' for Mitt Romney's 2008 presidential bid. Direct doc lookup, fastest path.
        schema:
          type: string
      - name: candidate_name
        in: query
        required: false
        description: 'Case-insensitive substring against the FEC-filed candidate name (typically LASTNAME, FIRSTNAME format). Example: ''mccormick'' or ''collins''.'
        schema:
          type: string
      - name: office
        in: query
        required: false
        description: 'Office code: H=House, S=Senate, P=President. Narrows ambiguous name matches.'
        schema:
          type: string
          enum:
          - H
          - S
          - P
      - name: state
        in: query
        required: false
        description: 2-letter state abbreviation (e.g., 'PA', 'CA'). Empty for President. Combine with office=S to find the senators from a state.
        schema:
          type: string
      - name: district
        in: query
        required: false
        description: House district as 2-digit string ('01'-'53') or 'AL' for at-large. Senate/President leave blank.
        schema:
          type: string
      - name: party
        in: query
        required: false
        description: 'Party code: DEM | REP | LIB | GRE | IND | OTH.'
        schema:
          type: string
      - name: cycle
        in: query
        required: false
        description: 'Election cycle year (e.g., 2026). Returns candidates whose cycles[] includes this value. Common cycles: 2022, 2024, 2026.'
        schema:
          type: integer
      - name: active_only
        in: query
        required: false
        description: When true, restricts to candidate_inactive=false (currently active filers). Default false (includes withdrawn / defeated / inactive).
        schema:
          type: boolean
      - name: include_committees
        in: query
        required: false
        description: When true (default), each returned candidate is enriched with a `committees` array containing all FEC committees linked via candidate_ids[]. The principal campaign committee (designation='P') is listed first. Set false to skip the committee fetch for faster responses when you only need candidate profile fields.
        schema:
          type: boolean
      - name: sort_by
        in: query
        required: false
        description: 'Sort key. Default: last_file_date (most recent first).'
        schema:
          type: string
          enum:
          - name
          - last_file_date
          - active_through
      - name: sort_order
        in: query
        required: false
        description: 'Default: desc.'
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: limit
        in: query
        required: false
        description: Maximum candidates to return. Default 50, max 500.
        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:
      - Fec Candidate Profile
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key