# ForgeMesh Election Candidate Search

> ForgeMesh Election Candidate Search is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-10).

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.

## Facts

- Endpoint: POST https://x402.forgemesh.io/election-candidate-search?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-election-candidate-search-b359f363
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AYkPDSL964hfKiD41TnrD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forgemesh-election-candidate-search-b359f363 -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "candidate": {
   "type": "string",
   "description": "candidate name, min 3 chars (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-election-candidate-search-b359f363/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)