US federal candidates (FEC)

Search US federal election candidates via the FEC: name, party, office (House/Senate/President), state, incumbent/challenger status, and FEC candidate ID. Live gov data. ?q=warren&limit=5

Input

Example output

{
  "query": "warren",
  "count": 1,
  "candidates": [
    {
      "name": "WARREN, ELIZABETH",
      "party": "DEMOCRATIC PARTY",
      "office": "Senate",
      "state": "MA",
      "status": "Incumbent",
      "candidateId": "S2MA00170"
    }
  ],
  "source": "api.open.fec.gov (public domain)"
}

Try it — see the 402 challenge (free)

curl -i "https://agent402.tools/api/fec-candidates?q=warren&limit=5"

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/fec-candidates?q=warren&limit=5");

Related tools