{"uid":"cap__gWanCJABUXteMgwMXwDY","slug":"fec-candidate-campaign-finance-totals-6ef87b45","name":"FEC Candidate Campaign Finance Totals","description":"Campaign finance totals for any US federal candidate: pass a name (or candidate id) and get official money numbers — total receipts, spending, cash on hand, debts, individual vs PAC contributions — for the latest election cycles, plus party, office, and state. One call replaces a search-then-totals API dance. For political-risk, news, and accountability agents.","url":"https://x402.forgemesh.io/fec-candidate-money","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"office":{"enum":["president","senate","house"],"type":"string","description":"prefer matches for this office"},"candidate":{"type":"string","description":"candidate name, min 3 chars"},"candidate_id":{"type":"string","description":"exact FEC candidate id, e.g. 'P80001571' (alternative to name)"}}},"responseSchema":{"type":"json","example":{"candidate":{"name":"PELOSI, NANCY","party":"DEMOCRATIC PARTY","state":"CA","office":"House","district":"11","candidate_id":"H8CA05035"},"attribution":"Federal Election Commission (public domain)","totals_by_cycle":[{"cycle":2026,"debts_usd":0,"receipts_usd":8123456.78,"cash_on_hand_usd":2100000.5,"disbursements_usd":6543210.99}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8_Z9HoDtmSTmV1UBW2oBE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns official FEC campaign finance totals for any US federal candidate — receipts, spending, cash on hand, debts, and contribution breakdowns by election cycle.","exampleAgentPrompt":"Pull the official FEC campaign finance totals for Nancy Pelosi — I want total receipts, cash on hand, disbursements, and any debts for the latest election cycle.","exampleUseCases":[{"title":"Political risk briefing on candidate","prompt":"I'm researching the financial health of Senate candidates in Georgia — can you get me the total receipts, cash on hand, and debts for Raphael Warnock from FEC records for the 2026 cycle?"},{"title":"Newsroom accountability check","prompt":"We're writing a piece on campaign spending — can you pull the official FEC disbursement and receipt totals for the House candidate with ID H8CA05035?"},{"title":"Comparing presidential fundraising","prompt":"For a voter guide, I need the latest FEC fundraising totals — total receipts and cash on hand — for any presidential candidates named Biden or Trump."}],"resultDescription":"A JSON object containing candidate metadata (name, party, state, office, district, FEC candidate ID), attribution to the FEC, and an array of per-election-cycle financial totals including receipts, disbursements, cash on hand, and debts — all in USD.","failureModes":["Candidate name too ambiguous — returns no match or wrong candidate if name is common","FEC candidate ID not found — returns error if ID is invalid or nonexistent","Candidate name too short (under 3 chars) — rejected by schema validation","No financial data available for a newly registered or inactive candidate","Office filter mismatches — specifying wrong office for a candidate may return no results"],"whenToPreferThis":"Use this endpoint when you need official FEC campaign finance totals for a specific US federal candidate in a single call, especially when you already have a name or FEC candidate ID. It eliminates the need to first search for a candidate and then separately fetch their financial summary. Prefer it over scraping FEC.gov directly, or over multi-step FEC API workflows, for political risk, journalism, accountability, and voter information agents.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:00:29.991Z","isFirstParty":false}