audit5

candidate11

committee7

communication cost4

dates4

debts2

disbursements8

efiling6

electioneering4

filer resources2

filings4

financial9

independent expenditures4

legal3

loans2

national party accounts3

party-coordinated expenditures2

presidential5

receipts13

search2

candidate

GET /v1/candidate/{candidate_id}/totals/

This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to two-year periods as a cycle.

The cycle is named after the even-numbered year and includes the year before it. To obtain totals from 2013 and 2014, you would use 2014. In odd-numbered years, the current cycle is the next year — for example, in 2015, the current cycle is 2016.

For presidential and Senate candidates, multiple two-year cycles exist between elections.

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
https://skmtc.dev/fec/apis/openfec/docs/v1/candidate/:candidate_id/totals/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

candidate_idstring required

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.

Query parameters

pageinteger

For paginating through results, starting at page 1

per_pageinteger

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

election_fullboolean

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

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.

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.