# FEC Candidate Search

> FEC Candidate Search is a paid API for AI agents from fittings.sh, paid per call via x402, $0.00598/call, status unknown (last checked 2026-09-14).

Search for federal election candidates by name and return their FEC candidate ID, party, office, state, and election years.

## Facts

- Endpoint: GET https://fittings.sh/v1/fec/candidate-search
- Price: $0.00598/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/fec-candidate-search-becb953c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CIT3bbsfQPcyLXzlcd5V8

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 fec-candidate-search-becb953c
```

Example prompt: Can you find the FEC candidate ID and party for any federal candidates named 'Alexandria Ocasio-Cortez' — I'm looking for House candidates from New York?

## When to prefer this

Use this endpoint when you need to look up federal election candidates by name and retrieve their official FEC identifiers, party, office, and election history. Prefer this over general web search when you need structured, authoritative FEC data (e.g., to cross-reference with campaign finance records). It is US federal candidates only — not useful for state or local races.

## Known failure modes

- No candidates found for the given name fragment — returns empty results list
- Invalid state code (not two-letter) may return an error or no results
- Limit parameter outside 1-100 range may be rejected
- Ambiguous or very common names may return up to the limit with no guarantee of the intended candidate
- FEC data may lag behind very recent candidate filings

## How this service works

Federal candidates matching a name, with their FEC candidate id, party, office, state and election years.

## Output

Returns a list of matching federal candidates, each including their FEC candidate ID, full name, party affiliation, office sought (House, Senate, or President), state, and the election years they have appeared on the ballot.

## Request schema (JSON Schema)

```json
{
 "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 or fragment"
      },
      "limit": {
       "type": "number",
       "description": "1-100, default 10"
      },
      "state": {
       "type": "string",
       "description": "Optional two-letter state code"
      },
      "office": {
       "type": "string",
       "description": "Optional: H (House), S (Senate) or P (President)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/fec-candidate-search-becb953c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from fittings.sh](https://www.zero.xyz/host/fittings.sh/llms.txt)