gov

Aggregate financial summaries (receipts, disbursements...

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.

get/api/gov/fec-totals

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/gov/fec-totals
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

scope'candidates' | 'committees' required

Scope.

candidateIdstring

Candidate ID.

committeeIdstring

Committee ID.

cycleinteger

Two-year US election cycle, given as the even-numbered end year (e.g. 2024).

office'P' | 'S' | 'H'

Office.

partystring

Party.

statestring

US state — two-letter postal abbreviation (e.g. CA) or full name.

districtstring

District.

electionFullboolean

Election full.

perPageinteger

Number of results to return per page.

pageinteger

Page number (1-based) for paginated results.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.