gov

Search US federal political candidates via the OpenFEC API.

Search US federal political candidates via the OpenFEC API. Filter by free-text q (name match), candidate ID (e.g. H0VA01076), state, district, party (DEM, REP, IND, LIB, GRE, etc.), office (P=President | S=Senate | H=House), election cycle (even years), election year, and hasRaised (only candidates with reported receipts). Returns FEC candidate ID, name, party, office, state/district, incumbency status, active-through cycle, first/last file dates, cycles, principal committee linkage. Use the candidate ID returned here to fetch their committees with /api/gov/fec-committee.

get/api/gov/fec-candidate

Request

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

Query parameters

qstring

Free-text search query.

candidateIdstring

Candidate ID.

statestring

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

districtstring

District.

partystring

Party.

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

Office.

cycleinteger

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

electionYearinteger

Election year.

hasRaisedboolean

Has raised.

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.