{"uid":"cap_TRbzG-hj2zii4EFqj_UUE","slug":"fec-candidate-lookup-b03a9bb9","name":"FEC Candidate Lookup","description":"US federal candidate lookup: search official election records by name and get matching candidates with their unique candidate ids, party, office sought, state, district, active-through year, and principal campaign committees. The cheap resolver step before pulling finance totals or joining candidates to trades and lobbying records.","url":"https://x402.forgemesh.io/fec-candidate-lookup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"candidate":{"type":"string","description":"candidate name, min 3 chars (required)"}}},"responseSchema":{"type":"json","example":{"query":{"candidate":"ossoff"},"matched":2,"returned":2,"candidates":[{"name":"OSSOFF, T. JONATHAN","party":"DEMOCRATIC PARTY","state":"GA","office":"Senate","district":null,"candidate_id":"S8GA00180","active_through":2026,"principal_committees":[{"name":"JON OSSOFF FOR SENATE","committee_id":"C00642406"}]}],"attribution":"Federal Election Commission (public domain)"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DtDh9MAFYXrx2Y-ksijtb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","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 records by candidate name and retrieve matching candidates with IDs, party, office, state, district, active years, and principal campaign committees.","exampleAgentPrompt":"Look up 'Warnock' in the FEC candidate records and give me his candidate ID, party, office, state, and principal campaign committee.","exampleUseCases":[{"title":"Resolve candidate before finance lookup","prompt":"Search the FEC records for 'Alexandria Ocasio-Cortez' and get me her candidate ID and committee ID so I can pull her campaign finance totals."},{"title":"Identify party and office for a politician","prompt":"Look up 'Ted Cruz' in the federal election records — I need his party, the office he's seeking, and his state."},{"title":"Cross-reference candidate with lobbying records","prompt":"Find the FEC candidate ID for 'Marco Rubio' so I can join his record to the lobbying and trade data I'm building."}],"resultDescription":"A JSON object containing the original query, number of matches found and returned, and an array of candidate objects each with: full name, party, state, office sought, district (if applicable), unique FEC candidate_id, active_through year, and a list of principal committees with committee name and committee_id. Attribution to the Federal Election Commission is included.","failureModes":["Candidate name shorter than 3 characters returns a validation error","Name typos or alternate spellings return zero matches","Common names (e.g. 'Smith') may return many partial matches requiring further filtering","Candidates who ran before digital FEC records may not appear","Response may include multiple candidates with similar names requiring disambiguation by state or office"],"whenToPreferThis":"Use this endpoint as the first resolver step whenever you need FEC candidate data by name — it converts a human-readable politician name into structured identifiers (candidate_id, committee_id) that can be used to query campaign finance totals, lobbying records, or trade disclosures. Prefer this over direct finance queries when you only have a name and need to establish identity first.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:49:19.157Z","isFirstParty":false,"canonicalSlug":"fec-candidate-lookup-b03a9bb9"}