FEfec
financial

GET /v1/elections/

Look at the top-level financial information for all candidates running for the same office.

Choose a 2-year cycle, and house, senate or presidential.

If you are looking for a Senate seat, you will need to select the state using a two-letter abbreviation.

House races require state and a two-digit district number.

Since this endpoint reflects financial information, it will only have candidates once they file financial reporting forms. Query the /candidates endpoint to retrieve an-up-to-date list of all the candidates that filed to run for a particular seat.

Request

  • Base URL
    https://api.open.fec.gov (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header X-Api-Key and API key in query parameter api_key and API key in query parameter api_key
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

pageinteger

For paginating through results, starting at page 1

per_pageinteger

The number of results returned per page. Defaults to 20.

statestring

US state or territory where a candidate runs for office

districtstring

Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00.

cycleinteger required

Two-year election cycle in which a candidate runs for office. Calculated from Form 2. The cycle begins with an odd year and is named for its ending, even year. This cycle follows the traditional house election cycle and subdivides the presidential and Senate elections into comparable two-year blocks. To retrieve data for the entire four years of a presidential term or six years of a senatorial term, you will need the election_full flag.

office'house' | 'senate' | 'president' required

Federal office candidate runs for: H, S or P

election_fullboolean

True indicates that full election period of a candidate. False indicates that two year election cycle.

sortstring

Provide a field to sort by. Use - for descending order.

sort_hide_nullboolean

Hide null values on sorted column(s).

sort_null_onlyboolean

Toggle that filters out all rows having sort column that is non-null

sort_nulls_lastboolean

Toggle that sorts null values last

api_keystring

API key for https://api.data.gov. Get one at https://api.data.gov/signup.

Response

Default response

Changes

No recorded changes to this operation across all 20 revisions of this API.