{"uid":"cap_fIfGCPvg0PVLhLnwTPe11","slug":"forgemesh-candidate-id-resolver-29469937","name":"ForgeMesh Candidate ID Resolver","description":"Resolve a politician's name to official candidate and committee identifiers used across US campaign-finance datasets. Fuzzy name in, exact ids out — the join key an agent needs before any deterministic money query.","url":"https://x402.forgemesh.io/candidate-id-resolver?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_QamWYR6n8y95svdOLAH4H","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":"Resolves a politician's name to official FEC candidate IDs and principal committee IDs used in US campaign-finance datasets.","exampleAgentPrompt":"Can you look up the FEC candidate ID and principal committee ID for Jon Ossoff so I can query his campaign finance donation records?","exampleUseCases":[{"title":"Pre-query enrichment for donation analysis","prompt":"Before I pull Jon Ossoff's donor list from the FEC, can you get me his candidate ID and committee ID so I have the right join keys?"},{"title":"Verify candidate office and party affiliation","prompt":"I need to confirm whether Raphael Warnock is listed as a Democratic Senate candidate in Georgia and get his FEC candidate ID."},{"title":"Multi-candidate campaign finance research","prompt":"I'm researching Senate race spending — can you resolve 'Warnock' and 'Walker' to their official FEC candidate IDs and committee IDs so I can pull their filings?"}],"resultDescription":"A JSON object containing the matched candidate count, and for each candidate: their full official name, party, state, office, district, FEC candidate_id, active_through year, and a list of principal committees each with a name and committee_id. Attribution to the Federal Election Commission is included.","failureModes":["Name string too short (under 3 characters) — API rejects request","No matching candidates found — returns matched:0 and empty candidates array","Ambiguous name matches multiple candidates — returns all matches, caller must disambiguate","Candidate not in FEC database (e.g. state/local-only politicians) — no results returned","Network or payment failure — x402 payment required before response is delivered"],"whenToPreferThis":"Use this endpoint as the first step in any US campaign-finance workflow when you have a politician's name but need their FEC candidate_id or committee_id to query donation, expenditure, or filing datasets. It handles fuzzy matching so you don't need the exact formatted name. Prefer this over manual FEC search when automating multi-candidate research pipelines or when building agents that need to join across FEC datasets by identifier.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:45:02.350Z","isFirstParty":false,"canonicalSlug":"forgemesh-candidate-id-resolver-29469937"}