{"uid":"cap_AYkPDSL964hfKiD41TnrD","slug":"forgemesh-election-candidate-search-b359f363","name":"ForgeMesh Election Candidate Search","description":"Search every registered US federal candidate — President, Senate, House — by name: returns candidate ids, party affiliation, office, state, district, and campaign committee ids as structured JSON. Ten best matches sorted by most recent filing activity.","url":"https://x402.forgemesh.io/election-candidate-search?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_naZBS9bEMHNepJ41RZOwX","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 all registered US federal candidates (President, Senate, House) by name and return structured profile data including party, office, state, district, and campaign committee IDs.","exampleAgentPrompt":"Can you look up Jon Ossoff in the federal candidate database and get me his FEC candidate ID, party, office, state, and campaign committee details?","exampleUseCases":[{"title":"Journalist researching campaign committee","prompt":"I'm writing about Georgia Senate races — can you search for Ossoff in the FEC candidate database and give me his candidate ID and principal committee ID?"},{"title":"Voter verifying candidate party affiliation","prompt":"I want to confirm which party Marjorie Taylor Greene is registered under as a federal candidate and what district she represents — can you pull that from the FEC records?"},{"title":"Political researcher building candidate dataset","prompt":"I need the FEC data for any federal candidates with the last name Warnock — candidate IDs, offices, states, and committee names please."}],"resultDescription":"A JSON object with the search query echoed back, a count of matched and returned candidates (up to 10, sorted by most recent filing activity), and an array of candidate objects each containing full name, party, state, office, district (or null), FEC candidate_id, active_through year, and an array of principal committees with name and committee_id. Attribution to the Federal Election Commission is included.","failureModes":["Candidate name shorter than 3 characters returns a validation error","Obscure or misspelled names may return zero matches","Candidates who have never filed with the FEC will not appear","Returns at most 10 results; very common names may omit some matches","Network or payment (x402) failures result in no response"],"whenToPreferThis":"Use this endpoint when you need structured FEC candidate profile data — IDs, party, office, district, committee links — for any registered US federal candidate. It is preferable to scraping FEC.gov directly, requires no FEC API key, and returns pre-ranked results by filing recency. Best for name-based lookups when you already know the candidate's name or partial name.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:32:11.256Z","isFirstParty":false,"canonicalSlug":"forgemesh-election-candidate-search-b359f363"}