FEfec
candidate

GET /v1/candidates/totals/

Aggregated candidate receipts and disbursements grouped by cycle.

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.

qstring[]

Name of candidate running for office

candidate_idstring[]

A unique identifier assigned to each candidate registered with the FEC. If a person runs for several offices, that person will have separate candidate IDs for each office. First character indicates office - [P]residential, [H]ouse, [S]enate]. Second character is the last digit of the two-year period the ID was created. Third and fourth is the candidate state. Presidential IDs don't have state. Fifth and sixth is the district when the candidate first ran. This does not change if the candidate/member's district changes during re-districting. Presidential IDs don't have districts. The rest is sequence.

election_yearinteger[]

Filter records to only those that were applicable to a given two-year period.The cycle begins with an odd year and is named for its ending, even year.

cycleinteger[]

Filter records to only those that were applicable to a given two-year period.The cycle begins with an odd year and is named for its ending, even year.

officestring[]

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.

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.

partystring[]

Three-letter party code

min_receiptsnumber

Minimum aggregated receipts

max_receiptsnumber

Maximum aggregated receipts

min_disbursementsnumber

Minimum aggregated disbursements

max_disbursementsnumber

Maximum aggregated disbursements

min_cash_on_hand_end_periodnumber

Minimum cash on hand

max_cash_on_hand_end_periodnumber

Maximum cash on hand

min_debts_owed_by_committeenumber

Minimum debt

max_debts_owed_by_committeenumber

Maximum debt

federal_funds_flagboolean

A boolean the describes if a presidential candidate has accepted federal funds. The flag will be false for House and Senate candidates.

has_raised_fundsboolean

A boolean that describes if a candidate's committee has ever received any receipts for their campaign for this particular office. (Candidates have separate candidate IDs for each office.)

is_active_candidateboolean

Candidates who are actively seeking office. If no value is specified, all candidates are returned. When True is specified, only active candidates are returned. When False is specified, only inactive candidates are returned.

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.