{"uid":"cap_YhUO3zCOUVTud5aHV9yCR","slug":"2s-io-f1c1c4cd","name":"FEC Campaign Finance Totals API","description":"Aggregate financial summaries (receipts, disbursements, cash-on-hand, debt, transfers, refunds, contributions by source, etc.) per cycle for federal candidates (scope=candidates) or committees (scope=committees). Filter by candidateId / committeeId, cycle, office (P/S/H), party, state, district. For candidates, electionFull=true rolls all cycles of a single election into one row (e.g. a presidential cycle spans 4 years). Use this for top-line \"how much did they raise/spend\" answers without paging through millions of itemized transactions.","url":"https://2s.io/api/gov/fec-totals","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["scope"],"properties":{"page":{"type":"integer","default":1,"minimum":1},"cycle":{"type":"integer"},"party":{"type":"string"},"scope":{"enum":["candidates","committees"],"type":"string"},"state":{"type":"string"},"office":{"enum":["P","S","H"],"type":"string"},"perPage":{"type":"integer","default":25,"maximum":100,"minimum":1},"district":{"type":"string"},"candidateId":{"type":"string"},"committeeId":{"type":"string"},"electionFull":{"type":"boolean","description":"Candidates only: aggregate full election cycle."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"cycle":2020,"scope":"candidates","candidateId":"P00009423","electionFull":true}}},"response":{"data":{"ok":true,"meta":{"scope":"candidates"},"page":{"size":25,"pages":1,"number":1},"items":[{"cycle":null,"receipts":43088972.4,"candidate_id":"P00009423","contributions":39623400.79,"disbursements":42943584.81,"election_full":true,"federal_funds":0,"loans_received":0,"other_receipts":488797.37,"last_report_year":2020,"coverage_end_date":"2020-12-31T00:00:00","net_contributions":38169952.51,"coverage_start_date":"2019-01-21T00:00:00","other_disbursements":248063.96,"contribution_refunds":1452763.28,"loan_repayments_made":0,"other_loans_received":0,"last_report_type_full":"YEAR-END","candidate_contribution":0,"operating_expenditures":41204757.57,"repayments_other_loans":0,"candidate_election_year":2020,"individual_contributions":39519855.67,"fundraising_disbursements":0,"transaction_coverage_date":"2020-12-31T00:00:00","net_operating_expenditures":39937397.53,"last_beginning_image_number":"202107279452125743","offsets_to_legal_accounting":0,"last_cash_on_hand_end_period":145387.59,"last_debts_owed_by_committee":0,"last_debts_owed_to_committee":0,"loans_received_from_candidate":0,"individual_itemized_contributions":23715867,"offsets_to_operating_expenditures":323792.3,"refunded_individual_contributions":1447518.28,"repayments_loans_made_by_candidate":0,"individual_unitemized_contributions":15803989,"offsets_to_fundraising_expenditures":0,"transfers_from_affiliated_committee":2652981.94,"exempt_legal_accounting_disbursement":0,"other_political_committee_contributions":103545.12,"political_party_committee_contributions":0,"total_offsets_to_operating_expenditures":323792.3,"transfers_to_other_authorized_committee":38000,"refunded_other_political_committee_contributions":5245,"refunded_political_party_committee_contributions":0}],"total":1,"source":{"url":"https://api.open.fec.gov/developers/","license":"US Government work, public domain.","provider":"OpenFEC API (Federal Election Commission)"}},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"gov.fec-totals","settlement":{"txHash":"0xdc886d4567b903eb3c15b288abb9a5f9c394bc6719129fb6710f8ef868a7406d","network":"eip155:8453","success":true}}}},"exampleRequest":{"cycle":2020,"scope":"candidates","candidateId":"P00009423","electionFull":true},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r07OBo1RHeEc2rbOGXUYT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregate financial summaries (receipts, disbursements, cash-on-hand, debt, contributions, refunds, transfers) per election cycle for federal candidates or committees","exampleAgentPrompt":"Can you pull up the top-line fundraising summary for presidential candidate P00009423 for the full 2020 election cycle — total raised, total spent, and cash on hand?","exampleUseCases":null,"resultDescription":"Returns one or more aggregate financial summary rows per election cycle, including total receipts, disbursements, cash-on-hand, debt, transfers, refunds, and contribution breakdowns by source — without requiring pagination through individual itemized transactions.","failureModes":["Missing required 'scope' parameter returns a 400 validation error","Invalid candidateId or committeeId returns empty results rather than an error","Unsupported office enum value (not P/S/H) causes a validation error","Requesting electionFull=true for a committee (only valid for candidates) may be ignored or return an error","Cycle values outside available FEC data range return empty result sets","Rate limiting or payment failure returns 402 if USDC balance is insufficient"],"whenToPreferThis":"Use this endpoint when you need quick top-line campaign finance totals (raised, spent, cash-on-hand, debt) for a federal candidate or committee without paging through millions of itemized transactions. Prefer this over itemized transaction endpoints when the user asks 'how much did they raise/spend' questions. Use electionFull=true for presidential races spanning multiple cycles. Best for summary dashboards, quick comparisons, and eligibility checks based on financial standing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:53:53.070Z","isFirstParty":false}