KeyVex Fec Contributions API
The Fec Contributions API from KeyVex — 1 operation(s) for fec contributions.
The Fec Contributions API from KeyVex — 1 operation(s) for fec contributions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/keyvex-com:keyvex-com-fec-contributions-api"
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.
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: 3.2.0
info:
title: KeyVex Fec Contributions 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 Contributions
paths:
/v1/fec-contributions:
get:
operationId: get_fec_contributions
summary: Returns FEC Schedule A contribution data — money flowing INTO federal…
description: 'Returns FEC Schedule A contribution data — money flowing INTO federal committees — in AGGREGATED form. Individual donors are never exposed as searchable per-record rows: the FEC sale-or-use rule (11 CFR 104.15) permits aggregated presentation only, so this tool serves group totals and a bounded ORGANISATION leaderboard (the same posture as Quiver Quantitative''s public pages). Source: api.open.fec.gov (official FEC API), queried live per request with a cached-rollup fallback (responses carry source: live | cache). THREE MODES (pick one): 1. Aggregate totals — pass group_by: - group_by=''employer'' + recipient_committee_id + cycle → total + count per employer for that committee (FEC-computed, all itemized rows). E.g. which employers'' workforces fund committee X. - group_by=''state'' + recipient_committee_id + cycle → geographic fundraising pattern for a committee. ⚠ On employer and state rows, contribution_count is the number of CONTRIBUTIONS, not contributors — the FEC publishes no contributor count for these aggregates. A cell can carry a dozen contributions from ONE person (measured: an employer cell with 14 contributions and a single contributor). Do not read it as a crowd, and do not use it to judge whether a cell describes a population or an individual. - group_by=''candidate'' + cycle (optionally candidate_id) → per- candidate cycle receipts, itemized-individual share, disbursements, cash on hand. Sorted by receipts DESC — ''who raised the most''. - group_by=''committee'' + recipient_committee_id (cycle optional) → that committee''s cycle totals. Top-committee LISTS come from the rollup cache and may lag a day. - group_by=''cycle'' + candidate_id or recipient_committee_id → per-cycle rows across cycles (fundraising trajectory). 2. Donor leaderboard — pass leaderboard=true + cycle + EXACTLY ONE scope: recipient_committee_id | candidate_id | contributor_state | contributor_employer. Returns top ORGANISATION donors (PAC / party / committee / company) as name + summed total + contribution count, PLUS the individual side as STATISTICS ONLY: individual_donor_count and individual_total. NO median and NO maximum are served — each is one person''s number (a median over an odd count IS one contributor''s gift) and re-identifies against the FEC''s own site. ⚠ SMALL-CELL FLOOR: when fewer than 5 distinct individuals contributed in the scope, the whole individual block is WITHHELD — count and total both null, suppressed=true, and the envelope carries suppressed_small_cells. Three donors plus a total is three people''s gifts nearly reconstructed, and the scope is public. The organisation board is never floored; entities are not natural persons. NO NATURAL PERSON IS NAMED BY THIS TOOL, IN ANY MODE. A paid service ranking named individuals by their contribution history is a prohibited commercial use of contributor lists (11 CFR 104.15; 52 U.S.C. 30111(a)(4)). An empty organisation list means no organisation gave in that scope above the floor — it is never a reason to look for people. No addresses, no city/ZIP, no per-record rows. The response''s leaderboard.complete flag is true when every itemized row at or above the fixed $1,000 floor (min_amount is not accepted in this mode) for the scope was aggregated — totals are then exact; otherwise the pull hit its page cap and ranks are amount-weighted approximations. 3. Per-record (NON-INDIVIDUAL only) — pass entity_type (COM, CCM, PAC, PTY, ORG) with optional recipient_committee_id / candidate_id / contributor_state / cycle / amount / date filters, or sub_id for a direct lookup. Individual (IND) rows are never returned per-record; memo subtotals are excluded by default (exclude_memos=false to include). Useful for PAC-to-PAC transfer analysis. There is NO contributor_name search and no individual street/city/ZIP anywhere in this tool''s output — by design, permanently. Killer query patterns: - Who raised the most this cycle? group_by=''candidate'' + cycle=2026. - Who funds Senator X?'
parameters:
- name: group_by
in: query
required: false
description: 'Aggregate mode: group totals by this axis. employer/state require recipient_committee_id + cycle (the FEC computes those per committee). cycle requires candidate_id or recipient_committee_id.'
schema:
type: string
enum:
- employer
- state
- candidate
- committee
- cycle
- name: leaderboard
in: query
required: false
description: 'Leaderboard mode: top ORGANISATION donors (PAC / party / committee / company) by name + summed total + count for ONE bounded scope, PLUS the individual side as statistics only (count and total — NO median and NO maximum; each is one person''s number and re-identifies against the FEC''s own site). Those statistics are WITHHELD ENTIRELY when fewer than 5 distinct individuals contributed in the scope. NO NATURAL PERSON IS NAMED — ranking named individuals by their giving is a prohibited commercial use of contributor lists (11 CFR 104.15). Requires cycle + exactly one of recipient_committee_id | candidate_id | contributor_state | contributor_employer.'
schema:
type: boolean
- name: recipient_committee_id
in: query
required: false
description: FEC committee ID (e.g. 'C00401224'). Scope for group_by='employer'/'state'/'committee'/'cycle', leaderboard scope, or per-record filter. Use get_fec_candidate_profile to find a candidate's principal committee.
schema:
type: string
- name: candidate_id
in: query
required: false
description: FEC candidate ID (e.g. 'S8GA00180'). Scope for group_by='candidate'/'cycle', leaderboard scope, or per-record filter.
schema:
type: string
- name: contributor_state
in: query
required: false
description: 2-letter state code. Leaderboard scope (top donors from a state) or per-record filter (non-individual rows).
schema:
type: string
- name: contributor_employer
in: query
required: false
description: Employer name (FEC substring match). LEADERBOARD SCOPE ONLY — top donors reporting this employer. Not available as a per-record filter.
schema:
type: string
- name: entity_type
in: query
required: false
description: 'Per-record mode selector — NON-INDIVIDUAL types only: COM (committee), CCM (candidate committee), PAC, PTY (party), ORG (organization). IND, UNK and CAN are not accepted: a CAN row is the FEC''s code for a CANDIDATE, who is a natural person, so candidate contributions are served aggregated only alongside every other individual.'
schema:
type: string
enum:
- COM
- CCM
- PAC
- PTY
- ORG
- name: sub_id
in: query
required: false
description: 'Per-record mode: direct doc lookup by FEC sub_id. Returns the row only when it is a non-individual contribution.'
schema:
type: string
- name: cycle
in: query
required: false
description: Election cycle year (2-year transaction period, e.g. 2026). Required for leaderboard and group_by='employer'/'state'; defaults to the current cycle for group_by='candidate'.
schema:
type: integer
- name: min_amount
in: query
required: false
description: 'Leaderboard: itemization floor for aggregated rows (default 1000; 200 = FEC itemization floor). Per-record: inclusive lower bound on amount.'
schema:
type: number
- name: max_amount
in: query
required: false
description: 'Per-record mode: inclusive upper bound on amount.'
schema:
type: number
- name: since
in: query
required: false
description: 'Per-record mode: inclusive lower bound on contribution_receipt_date (YYYY-MM-DD).'
schema:
type: string
- name: until
in: query
required: false
description: 'Per-record mode: inclusive upper bound on contribution_receipt_date (YYYY-MM-DD).'
schema:
type: string
- name: exclude_memos
in: query
required: false
description: 'Per-record mode: when true (DEFAULT) filters out memoed_subtotal rows (FEC duplicates that double-count dollars). Leaderboards always exclude them.'
schema:
type: boolean
- name: sort_by
in: query
required: false
description: 'Per-record mode sort key. Default: contribution_receipt_date.'
schema:
type: string
enum:
- contribution_receipt_date
- contribution_receipt_amount
- name: sort_order
in: query
required: false
description: 'Per-record mode: default desc.'
schema:
type: string
enum:
- asc
- desc
- name: limit
in: query
required: false
description: Max rows (aggregate/per-record) or max ORGANISATIONS (leaderboard, default 100). 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 Contributions
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key