{"ok":true,"site":"fec","host":"fec.gov","about":"FEC.gov campaign finance data (via the public OpenFEC API at api.open.fec.gov/v1). The CLI covers candidate and committee lookups, fundraising and spending totals, itemized receipts and disbursements, outside spending, filings, elections, calendars and advisory opinions.","commands":[{"command":"search-candidate-names","summary":"Autocomplete or search candidates by name and get their FEC candidate IDs","params":[{"name":"q","type":"string","required":true,"description":"Candidate name or part of it"},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/search-candidate-names?q=Ossoff"},{"command":"search-committee-names","summary":"Autocomplete or search committees (campaigns, PACs, parties) by name and get their FEC committee IDs","params":[{"name":"q","type":"string","required":true,"description":"Committee name or part of it"},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/search-committee-names?q=Ossoff"},{"command":"list-candidate-totals","summary":"Rank candidates by money raised, spent, or cash on hand for an election year, optionally filtered by office or state (raising/spending 'by the numbers')","params":[{"name":"election_year","type":"number","required":true,"description":"Election year, e.g. 2026"},{"name":"office","type":"string","description":"Office sought: P=President, S=Senate, H=House","oneOf":["P","S","H"]},{"name":"state","type":"string","description":"Two-letter state code, e.g. GA"},{"name":"sort","type":"string","description":"Sort key. Prefix with - for descending.","oneOf":["-receipts","-disbursements","-individual_itemized_contributions","-cash_on_hand_end_period","-debts_owed_by_committee"],"default":"-receipts"},{"name":"is_active_candidate","type":"boolean","description":"Only active candidates","default":true},{"name":"election_full","type":"boolean","description":"Totals for the full election period (true) or the two-year cycle only (false)","default":true},{"name":"per_page","type":"number","description":"Results per page (max 100)","default":10},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-candidate-totals?election_year=2026&office=S"},{"command":"get-candidate-totals-aggregates","summary":"Get total receipts, disbursements and cash on hand summed across all candidates for an office, optionally broken down by party","params":[{"name":"election_year","type":"number","required":true,"description":"Election year, e.g. 2026"},{"name":"office","type":"string","description":"Office: P, S or H","oneOf":["P","S","H"]},{"name":"aggregate_by","type":"string","description":"Grouping: by office, or by office and party","oneOf":["office","office-party"],"default":"office"},{"name":"is_active_candidate","type":"boolean","description":"Only active candidates","default":true},{"name":"election_full","type":"boolean","description":"Full election period totals","default":true},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/get-candidate-totals-aggregates?election_year=2026&office=S"},{"command":"get-candidate-totals","summary":"Get a candidate's detailed financial totals (receipts, contributions, loans, spending, cash on hand) for an election","params":[{"name":"candidate_id","type":"string","required":true,"description":"FEC candidate ID, e.g. S8GA00180"},{"name":"cycle","type":"number","description":"Election year / cycle, e.g. 2026","default":2026},{"name":"election_full","type":"boolean","description":"Full election period (true) or two-year cycle (false)","default":true},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/get-candidate-totals?cycle=2026"},{"command":"get-candidate-committees","summary":"List a candidate's principal and authorized campaign committees for a cycle, with committee IDs, treasurer and address","params":[{"name":"candidate_id","type":"string","required":true,"description":"FEC candidate ID"},{"name":"cycle","type":"number","required":true,"description":"Election cycle year, e.g. 2026"},{"name":"election_full","type":"boolean","description":"Full election period","default":true},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/get-candidate-committees"},{"command":"list-election-candidates","summary":"List the candidates in a specific race (President, a state's Senate seat, or a House district) with their receipts, spending and cash on hand","params":[{"name":"office","type":"string","required":true,"description":"Office of the race","oneOf":["president","senate","house"]},{"name":"cycle","type":"number","required":true,"description":"Election year, e.g. 2026"},{"name":"state","type":"string","description":"Two-letter state code. Required for senate and house."},{"name":"district","type":"string","description":"Two-digit House district, e.g. 05 (house only)"},{"name":"election_full","type":"boolean","description":"Totals over the full election period","default":true},{"name":"sort","type":"string","description":"Sort key","oneOf":["-total_receipts","-total_disbursements","-cash_on_hand_end_period"],"default":"-total_receipts"},{"name":"per_page","type":"number","description":"Results per page","default":100},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-election-candidates?office=senate&cycle=2026&state=GA"},{"command":"search-elections","summary":"Find the federal races (office, state, district) for a cycle by state or ZIP code","params":[{"name":"cycle","type":"number","required":true,"description":"Election year, e.g. 2026"},{"name":"state","type":"string","description":"Two-letter state code, or US for presidential"},{"name":"zip","type":"string","description":"5-digit ZIP code (alternative to state)"},{"name":"district","type":"string","description":"Two-digit House district"},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/search-elections?cycle=2026&state=GA&zip=90210"},{"command":"list-election-dates","summary":"List upcoming (or past) federal election dates by state, office and election type","params":[{"name":"min_election_date","type":"string","description":"Earliest election date, YYYY-MM-DD"},{"name":"max_election_date","type":"string","description":"Latest election date, YYYY-MM-DD"},{"name":"election_state","type":"string","description":"Two-letter state code"},{"name":"per_page","type":"number","description":"Results per page","default":20},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-election-dates?min_election_date=2026-10-18"},{"command":"list-calendar-dates","summary":"List FEC calendar events (reporting deadlines, IE periods, elections, meetings) in a date range","params":[{"name":"min_start_date","type":"string","required":true,"description":"Range start, YYYY-MM-DD"},{"name":"max_start_date","type":"string","required":true,"description":"Range end, YYYY-MM-DD"},{"name":"calendar_category_id","type":"number","description":"Category ID filter (e.g. 25=Quarterly, 29=IE Periods)"},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-calendar-dates?min_start_date=2026-10-01&max_start_date=2026-11-01"},{"command":"list-contributions-by-state","summary":"Break down a candidate's itemized individual contributions by contributor state (total and count per state)","params":[{"name":"candidate_id","type":"string","required":true,"description":"FEC candidate ID"},{"name":"cycle","type":"number","required":true,"description":"Election cycle, e.g. 2026"},{"name":"election_full","type":"boolean","description":"Full election period (true) or two-year cycle (false)","default":false},{"name":"per_page","type":"number","description":"Results per page","default":99},{"name":"page","type":"number","description":"Page number","default":1},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-contributions-by-state?candidate_id=S8GA00180&cycle=2026"},{"command":"get-contributions-by-state-total","summary":"Get a candidate's total itemized individual contributions summed across all states","params":[{"name":"candidate_id","type":"string","required":true,"description":"FEC candidate ID"},{"name":"cycle","type":"number","required":true,"description":"Election cycle"},{"name":"office","type":"string","description":"Office: P, S or H","oneOf":["P","S","H"]},{"name":"election_full","type":"boolean","description":"Full election period","default":true},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/get-contributions-by-state-total?candidate_id=S6TX00479&cycle=2026&office=S"},{"command":"list-contributions-by-size","summary":"Break down a candidate's individual contributions by contribution size bucket (0 = unitemized under $200, 200, 500, 1000, 2000)","params":[{"name":"candidate_id","type":"string","required":true,"description":"FEC candidate ID"},{"name":"cycle","type":"number","required":true,"description":"Election cycle"},{"name":"election_full","type":"boolean","description":"Full election period","default":false},{"name":"per_page","type":"number","description":"Results per page","default":10},{"name":"api_key","type":"string","description":"api.data.gov API key. DEMO_KEY works but is heavily rate-limited; a free key is available at api.data.gov/signup","default":"DEMO_KEY"}],"exampleUrl":"https://clify-dev.netlify.app/fec/list-contributions-by-size?candidate_id=S8GA00180&cycle=2026"},{"command":"get-advisory-opinion","summary":"Get an FEC advisory opinion's documents (date, title, PDF link) by AO number","params":[{"name":"ao_no","type":"string","required":true,"description":"Advisory opinion number YYYY-NN, e.g. 2025-08"}],"exampleUrl":"https://clify-dev.netlify.app/fec/get-advisory-opinion"}]}