Get candidate candidate id history cycle

Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to know more about a candidate's previous races. This information is organized by candidate_id, so it won't help you find a candidate who ran for different offices over time; candidates get a new ID for each office.

Usage

fec_get_candidate_candidate_id_history_cycle(
  sort_nulls_last,
  per_page,
  sort_null_only,
  sort_hide_null,
  sort,
  election_full,
  page,
  candidate_id,
  cycle,
  api_key = Sys.getenv("FEC_API_KEY", unset = "DEMO_KEY")
)

Arguments

sort_nulls_last

Toggle that sorts null values last

per_page

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

sort_null_only

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

sort_hide_null

Hide null values on sorted column(s).

sort

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

election_full

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

page

For paginating through results, starting at page 1

candidate_id

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.

cycle

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.

api_key

An API key provided by the API provider. This key is not clearly documented in the API description. Check the API documentation for details.

Value

BKTODO: Return descriptions are not yet implemented in beekeeper