Skip to contents

Each report represents the summary information from Form 3, Form 3X and Form 3P. These reports have key statistics that illuminate the financial status of a given committee. Things like cash on hand, debts owed by committee, total receipts, and total disbursements are especially helpful for understanding a committee's financial dealings. By default, this endpoint includes both amended and final versions of each report. To restrict to only the final versions of each report, use is_amended=false; to retrieve only reports that have been amended, use is_amended=true. Several different reporting structures exist, depending on the type of organization that submits financial information. To see an example of these reporting requirements, look at the summary and detailed summary pages of Form 3, Form 3X, and Form 3P. DISCLAIMER: The field labels contained within this resource are subject to change. We are attempting to succinctly label these fields while conveying clear meaning to ensure accessibility for all users.

Usage

fec_get_committee_committee_id_reports(
  min_debts_owed_amount,
  max_disbursements_amount,
  max_total_contributions,
  max_debts_owed_expenditures,
  cycle,
  sort_nulls_last,
  sort_hide_null,
  year,
  max_receipts_amount,
  max_cash_on_hand_end_period_amount,
  is_amended,
  min_disbursements_amount,
  max_party_coordinated_expenditures,
  per_page,
  max_independent_expenditures,
  min_receipts_amount,
  min_party_coordinated_expenditures,
  candidate_id,
  beginning_image_number,
  page,
  type,
  sort,
  min_total_contributions,
  min_cash_on_hand_end_period_amount,
  sort_null_only,
  min_independent_expenditures,
  report_type,
  committee_id,
  api_key = Sys.getenv("FEC_API_KEY", unset = "DEMO_KEY")
)

Arguments

min_debts_owed_amount

Filter for all amounts greater than a value.

max_disbursements_amount

Filter for all amounts less than a value.

max_total_contributions

Filter for all amounts less than a value.

max_debts_owed_expenditures

Filter for all amounts less than a value.

cycle

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.

sort_nulls_last

Toggle that sorts null values last

sort_hide_null

Hide null values on sorted column(s).

year

Forms with coverage date - year from the coverage ending date. Forms without coverage date - year from the receipt date.

max_receipts_amount

Filter for all amounts less than a value.

max_cash_on_hand_end_period_amount

Filter for all amounts less than a value.

is_amended

False indicates that a report is the most recent. True indicates that the report has been superseded by an amendment.

min_disbursements_amount

Filter for all amounts greater than a value.

max_party_coordinated_expenditures

Filter for all amounts less than a value.

per_page

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

max_independent_expenditures

Filter for all amounts less than a value.

min_receipts_amount

Filter for all amounts greater than a value.

min_party_coordinated_expenditures

Filter for all amounts greater than a value.

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.

beginning_image_number

Unique identifier for the electronic or paper report. This number is used to construct PDF URLs to the original document.

page

For paginating through results, starting at page 1

type

The one-letter type code of the organization: - C communication cost - D delegate - E electioneering communication - H House - I independent expenditure filer (not a committee) - N PAC - nonqualified - O independent expenditure-only (super PACs) - P presidential - Q PAC - qualified - S Senate - U single candidate independent expenditure - V PAC with non-contribution account, nonqualified - W PAC with non-contribution account, qualified - X party, nonqualified - Y party, qualified - Z national party non-federal account

sort

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

min_total_contributions

Filter for all amounts greater than a value.

min_cash_on_hand_end_period_amount

Filter for all amounts greater than a value.

sort_null_only

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

min_independent_expenditures

Filter for all amounts greater than a value.

report_type

Report type; prefix with "-" to exclude. Name of report where the underlying data comes from: - 10D Pre-Election - 10G Pre-General - 10P Pre-Primary - 10R Pre-Run-Off - 10S Pre-Special - 12C Pre-Convention - 12G Pre-General - 12P Pre-Primary - 12R Pre-Run-Off - 12S Pre-Special - 30D Post-Election - 30G Post-General - 30P Post-Primary - 30R Post-Run-Off - 30S Post-Special - 60D Post-Convention - M1 January Monthly - M10 October Monthly - M11 November Monthly - M12 December Monthly - M2 February Monthly - M3 March Monthly - M4 April Monthly - M5 May Monthly - M6 June Monthly - M7 July Monthly - M8 August Monthly - M9 September Monthly - MY Mid-Year Report - Q1 April Quarterly - Q2 July Quarterly - Q3 October Quarterly - TER Termination Report - YE Year-End - ADJ COMP ADJUST AMEND - CA COMPREHENSIVE AMEND

committee_id

A unique identifier assigned to each committee or filer registered with the FEC. In general committee id's begin with the letter C which is followed by eight digits.

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