{"uid":"cap_D7Td-yAuaJ3UqkkwZc16Z","slug":"2s-io-45cff346","name":"FEC Candidate Search","description":"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.","url":"https://2s.io/api/gov/fec-candidate","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":{"properties":{"q":{"type":"string"},"page":{"type":"integer","default":1,"minimum":1},"cycle":{"type":"integer","description":"Election cycle (even year)."},"party":{"type":"string"},"state":{"type":"string"},"office":{"enum":["P","S","H"],"type":"string"},"perPage":{"type":"integer","default":25,"maximum":100,"minimum":1},"district":{"type":"string","description":"2-digit district, e.g. \"03\"."},"hasRaised":{"type":"boolean"},"candidateId":{"type":"string"},"electionYear":{"type":"integer"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"q":"Smith","page":1,"cycle":2024,"state":"GA","office":"S","perPage":25,"hasRaised":true}}},"response":{"data":{"ok":true,"page":{"size":25,"pages":1,"number":1},"items":[{"name":"DILLARD SMITH, MAYA","party":"DEM","state":"GA","cycles":[2020,2022,2024],"office":"S","district":"00","partyFull":"DEMOCRATIC PARTY","lastF2Date":"2019-11-26","officeFull":"Senate","candidateId":"S0GA00500","lastFileDate":"2019-11-26","activeThrough":2020,"electionYears":[2020],"firstFileDate":"2019-11-26","districtNumber":0,"hasRaisedFunds":true,"incumbentChallenge":"C","principalCommittees":[{"name":"MAYA FOR GEORGIA","party":"DEM","state":"GA","cycles":[2020,2022,2024],"party_full":"DEMOCRATIC PARTY","designation":"P","committee_id":"C00728782","last_f1_date":"2020-06-08","candidate_ids":["S0GA00500"],"first_f1_date":"2019-11-26","committee_type":"S","last_file_date":"2023-06-15","treasurer_name":"DILLARD SMITH, MAYA","first_file_date":"2019-11-26","designation_full":"Principal campaign committee","filing_frequency":"A","organization_type":null,"committee_type_full":"Senate","designated_agent_zip":null,"designated_agent_city":null,"designated_agent_name":null,"designated_agent_state":null,"designated_agent_title":null,"organization_type_full":null,"designated_agent_prefix":null,"designated_agent_suffix":null,"designated_agent_street1":null,"designated_agent_street2":null,"affiliated_committee_name":"NONE","designated_agent_last_name":null,"designated_agent_first_name":null,"designated_agent_middle_name":null,"designated_agent_phone_number":null}],"incumbentChallengeFull":"Challenger"}],"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-candidate","settlement":{"txHash":"0xcdaebcbcd92245c6949b2001e27f3397919ac1b793e68042cd849e222b0cb786","network":"eip155:8453","success":true}}}},"exampleRequest":{"q":"Smith","page":1,"cycle":2024,"state":"GA","office":"S","perPage":25,"hasRaised":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_OII9ZrkDGYUtjO7K_wJ5U","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":"Search and filter US federal political candidates via the OpenFEC API, returning candidate identity, party, office, incumbency, and committee linkage data.","exampleAgentPrompt":"Can you look up FEC candidate information for Democratic Senate candidates in Georgia from the 2024 election cycle — specifically any candidate who has raised money?","exampleUseCases":null,"resultDescription":"Returns a paginated list of FEC candidate records, each containing the candidate's FEC ID, full name, party abbreviation, office sought (P/S/H), state and district, incumbency status, active-through election cycle, first and last filing dates, all election cycles they appear in, and their linked principal committee ID. Use the returned candidate ID to fetch detailed committee data from /api/gov/fec-committee.","failureModes":["No candidates found matching the given filters — returns empty results list","Invalid office value (not P, S, or H) — returns validation error","Invalid or unrecognized candidateId format — returns empty results or 400 error","Rate limit or payment failure (x402) — returns 402 Payment Required","Invalid state abbreviation or district format — returns empty or malformed results","electionYear or cycle provided as odd number — may return empty results since FEC uses even-year cycles"],"whenToPreferThis":"Use this endpoint when you need to search or discover US federal political candidates by name, party, office, state, or election cycle using official FEC data. Prefer this over generic web search when you need structured, authoritative candidate identifiers (FEC candidate IDs) that can be chained into subsequent calls like /api/gov/fec-committee to pull fundraising committee data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:24.341Z","isFirstParty":false}