API reference/Economic Indicators/Federal Election Candidates

Federal Election Candidates

Find House, Senate and presidential candidates by name or state: FEC id, party, office, district, incumbency and campaign committees.

GET/api/v1/economy/elections/candidates

Data source

Query parameters

ParameterDescriptionTry value
name
string
Candidate name contains
state
string
Two-letter state code
office
string
house, senate or president
cycle
number
Election cycle (even year)
limit
number
Rows (default 20, max 50)
apikey
string required
Your API key. Can also be sent as the X-API-Key header.demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.