{"uid":"cap_BG94IWV53h7KGvAhhEkxf","slug":"fec-candidate-search-40f0e9db","name":"FEC Candidate Search","description":"Search US federal election candidates via the FEC: name, party, office (House/Senate/President), state, incumbent/challenger status, and FEC candidate ID. Live gov data. ?q=warren&limit=5","url":"https://agent402.tools/api/fec-candidates","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"Candidate name to search"},"limit":{"type":"number","description":"Max results 1-20 (default 5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["query","count","candidates","source"],"properties":{"count":{"type":"integer"},"query":{"type":"string"},"source":{"type":"string"},"candidates":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"party":{"type":"string"},"state":{"type":"string"},"office":{"type":"string"},"status":{"type":"string"},"candidateId":{"type":"string"}}}}}}}}}},"responseSchema":{"type":"json","example":{"count":1,"query":"warren","source":"api.open.fec.gov (public domain)","candidates":[{"name":"WARREN, ELIZABETH","party":"DEMOCRATIC PARTY","state":"MA","office":"Senate","status":"Incumbent","candidateId":"S2MA00170"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dWa__UThkBcxBHHqyNMis","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search US federal election candidates by name, party, office, state, and incumbency using live FEC data","exampleAgentPrompt":"Search the FEC for federal candidates with the last name 'Warren' and show me their office, party, state, and whether they're incumbents — give me up to 10 results.","exampleUseCases":null,"resultDescription":"A list of matching federal election candidates (up to the specified limit), each including full name, party affiliation, office sought (House/Senate/President), state, incumbent or challenger status, and FEC candidate ID — sourced from live FEC government data.","failureModes":["No candidates found matching the query string — returns empty results","Query parameter 'q' missing — returns 400 or validation error","Limit out of range (not 1-20) — may be clamped or return error","FEC upstream API unavailable — may return 500 or timeout","Very common name returns max results without the specific candidate sought"],"whenToPreferThis":"Use this endpoint when you need live, authoritative US federal election candidate data from the FEC — specifically to look up candidate names, identify which office they're running for, verify party affiliation, find FEC candidate IDs, or distinguish incumbents from challengers. Prefer this over general web search when you need structured, queryable candidate records rather than news articles or bios.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:00:46.513Z","isFirstParty":false}