--- title: "GET /v1/committee/{committee_id}/reports/" method: GET path: "/v1/committee/{committee_id}/reports/" tags: ["financial"] --- # GET /v1/committee/{committee_id}/reports/ `GET /v1/committee/{committee_id}/reports/` ## Request - Base URL: `https://api.open.fec.gov` (the document declares no server; this is the origin it was published from) - URL: `https://api.open.fec.gov/v1/committee/{committee_id}/reports/` - 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) 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. ## Path parameters - `committee_id` string, required ## Query parameters - `page` integer - `per_page` integer - `year` integer[] - `cycle` integer[] - `beginning_image_number` string[] - `report_type` string[] - `is_amended` boolean - `min_disbursements_amount` number - `max_disbursements_amount` number - `min_receipts_amount` number - `max_receipts_amount` number - `min_cash_on_hand_end_period_amount` number - `max_cash_on_hand_end_period_amount` number - `min_debts_owed_amount` number - `max_debts_owed_expenditures` number - `min_independent_expenditures` number - `max_independent_expenditures` number - `min_party_coordinated_expenditures` number - `max_party_coordinated_expenditures` number - `min_total_contributions` number - `max_total_contributions` number - `type` string[] - `sort` string[] - `sort_hide_null` boolean - `sort_null_only` boolean - `sort_nulls_last` boolean - `api_key` string ## Response `default` Default response - CommitteeReportsPage - `pagination` OffsetInfo - `count` integer - `is_count_exact` boolean - `page` integer - `pages` integer - `per_page` integer - `results` CommitteeReports[] - `aggregate_amount_personal_contributions_general` number - `aggregate_contributions_personal_funds_primary` number - `all_loans_received_period` number - `all_loans_received_ytd` number - `all_other_loans_period` number - `all_other_loans_ytd` number - `allocated_federal_election_levin_share_period` number - `amendment_chain` number[], nullable: The first value in the chain is the original filing. The ordering in the chain reflects the order the amendments were filed up to the amendment being inspected. - `amendment_indicator` string, nullable - `amendment_indicator_full` string, nullable - `beginning_image_number` string - `calendar_ytd` integer, nullable - `candidate_contribution_period` number - `candidate_contribution_ytd` number - `cash_on_hand_beginning_calendar_ytd` number - `cash_on_hand_beginning_period` number - `cash_on_hand_close_ytd` number - `cash_on_hand_end_period` number - `committee_id` string, nullable: A unique identifier assigned to each committee or filer registered with the FEC. In general a committee id begins with the letter C which is followed by eight digits. - `committee_name` string, nullable: The name of the committee. If a committee changes its name, the most recent name will be shown. Committee names are not unique. Use committee_id for looking up records. - `committee_type` string - `coordinated_expenditures_by_party_committee_period` number - `coordinated_expenditures_by_party_committee_ytd` number - `coverage_end_date` string, date-time, nullable: Ending date of the reporting period - `coverage_start_date` string, date-time, nullable: Beginning date of the reporting period - `csv_url` string - `cycle` integer, nullable: Filter records to only those that are applicable to a given two-year period. This cycle follows the traditional House election cycle and subdivides the presidential and Senate elections into comparable two-year blocks. The cycle begins with an odd year and is named for its ending, even year. - `debts_owed_by_committee` number - `debts_owed_to_committee` number - `document_description` string - `end_image_number` string - `exempt_legal_accounting_disbursement_period` number - `exempt_legal_accounting_disbursement_ytd` number - `expenditure_subject_to_limits` number - `fec_file_id` string - `fec_url` string - `fed_candidate_committee_contribution_refunds_ytd` number - `fed_candidate_committee_contributions_period` number - `fed_candidate_committee_contributions_ytd` number - `fed_candidate_contribution_refunds_period` number - `federal_funds_period` number - `federal_funds_ytd` number - `file_number` integer, nullable - `fundraising_disbursements_period` number - `fundraising_disbursements_ytd` number - `gross_receipt_authorized_committee_general` number - `gross_receipt_authorized_committee_primary` number - `gross_receipt_minus_personal_contribution_general` number - `gross_receipt_minus_personal_contributions_primary` number - `html_url` string, nullable: HTML link to the filing. - `independent_contributions_period` number - `independent_expenditures_period` number - `independent_expenditures_ytd` number - `individual_itemized_contributions_period` number, nullable: Individual itemized contributions are from individuals whose aggregate contributions total over $200 per individual per year. Be aware, some filers choose to itemize donations $200 or less. total for the reporting period - `individual_itemized_contributions_ytd` number, nullable: Individual itemized contributions are from individuals whose aggregate contributions total over $200 per individual per year. Be aware, some filers choose to itemize donations $200 or less. total for the year to date - `individual_unitemized_contributions_period` number, nullable: Unitemized contributions are made individuals whose aggregate contributions total $200 or less per individual per year. Be aware, some filers choose to itemize donations $200 or less and in that case those donations will appear in the itemized total. total for the reporting period - `individual_unitemized_contributions_ytd` number, nullable: Unitemized contributions are made individuals whose aggregate contributions total $200 or less per individual per year. Be aware, some filers choose to itemize donations $200 or less and in that case those donations will appear in the itemized total. total for the year to date - `is_amended` boolean, nullable: False indicates that a report is the most recent. True indicates that the report has been superseded by an amendment. - `items_on_hand_liquidated` number - `loan_repayments_candidate_loans_period` number - `loan_repayments_candidate_loans_ytd` number - `loan_repayments_made_period` number - `loan_repayments_made_ytd` number - `loan_repayments_other_loans_period` number - `loan_repayments_other_loans_ytd` number - `loan_repayments_received_period` number - `loan_repayments_received_ytd` number - `loans_made_by_candidate_period` number - `loans_made_by_candidate_ytd` number - `loans_made_period` number - `loans_made_ytd` number - `loans_received_from_candidate_period` number - `loans_received_from_candidate_ytd` number - `means_filed` string, nullable: The method used to file with the FEC, either electronic or on paper. - `most_recent` boolean, nullable: Report is either new or is the most-recently filed amendment - `most_recent_file_number` number - `net_contributions_cycle_to_date` number - `net_contributions_period` number - `net_contributions_ytd` number - `net_operating_expenditures_cycle_to_date` number - `net_operating_expenditures_period` number - `net_operating_expenditures_ytd` number - `non_allocated_fed_election_activity_period` number - `non_allocated_fed_election_activity_ytd` number - `nonfed_share_allocated_disbursements_period` number - `offsets_to_fundraising_expenditures_period` number - `offsets_to_fundraising_expenditures_ytd` number - `offsets_to_legal_accounting_period` number - `offsets_to_legal_accounting_ytd` number - `offsets_to_operating_expenditures_period` number, nullable: Offsets to operating expenditures total for the reporting period - `offsets_to_operating_expenditures_ytd` number, nullable: Offsets to operating expenditures total for the year to date - `operating_expenditures_period` number - `operating_expenditures_ytd` number - `other_disbursements_period` number - `other_disbursements_ytd` number - `other_fed_operating_expenditures_period` number - `other_fed_operating_expenditures_ytd` number - `other_fed_receipts_period` number - `other_fed_receipts_ytd` number - `other_loans_received_period` number - `other_loans_received_ytd` number - `other_political_committee_contributions_period` number - `other_political_committee_contributions_ytd` number - `other_receipts_period` number - `other_receipts_ytd` number - `pdf_url` string - `political_party_committee_contributions_period` number - `political_party_committee_contributions_ytd` number - `previous_file_number` number - `receipt_date` string, date, nullable: Date the FEC received the electronic or paper record - `refunded_individual_contributions_period` number - `refunded_individual_contributions_ytd` number - `refunded_other_political_committee_contributions_period` number - `refunded_other_political_committee_contributions_ytd` number - `refunded_political_party_committee_contributions_period` number - `refunded_political_party_committee_contributions_ytd` number - `refunds_total_contributions_col_total_ytd` number - `repayments_loans_made_by_candidate_period` number - `repayments_loans_made_candidate_ytd` number - `repayments_other_loans_period` number - `repayments_other_loans_ytd` number - `report_form` string - `report_type` string, nullable: 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 - 90S Post Inaugural Supplement - 90D Post Inaugural - 24 24 Hour Notification (F6, F9) - 24 24 Hour Report of Independent Expenditures (F5, F24/F3X) - 48 48 Hour Report of Independent Expenditures (F5, F24/F3X) - M7S July Monthly/Semi-Annual - MSA Monthly Semi-Annual (MY) - MYS Monthly Year End/Semi-Annual - Q2S July Quarterly/Semi-Annual - QSA Quarterly Semi-Annual (MY) - QYS Quarterly Year End/Semi-Annual - QYE Quarterly Semi-Annual (YE) - QMS Quarterly Mid-Year/ Semi-Annual - MSY Monthly Semi-Annual (YE) - `report_type_full` string, nullable: 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 - 90S Post Inaugural Supplement - 90D Post Inaugural - 24 24 Hour Notification (F6, F9) - 24 24 Hour Report of Independent Expenditures (F5, F24/F3X) - 48 48 Hour Report of Independent Expenditures (F5, F24/F3X) - M7S July Monthly/Semi-Annual - MSA Monthly Semi-Annual (MY) - MYS Monthly Year End/Semi-Annual - Q2S July Quarterly/Semi-Annual - QSA Quarterly Semi-Annual (MY) - QYS Quarterly Year End/Semi-Annual - QYE Quarterly Semi-Annual (YE) - QMS Quarterly Mid-Year/ Semi-Annual - MSY Monthly Semi-Annual (YE) - `report_year` integer, nullable: Forms with coverage date - year from the coverage ending date. Forms without coverage date - year from the receipt date. - `shared_fed_activity_nonfed_ytd` number - `shared_fed_activity_period` number - `shared_fed_activity_ytd` number - `shared_fed_operating_expenditures_period` number - `shared_fed_operating_expenditures_ytd` number - `shared_nonfed_operating_expenditures_period` number - `shared_nonfed_operating_expenditures_ytd` number - `subtotal_period` number - `subtotal_summary_page_period` number - `subtotal_summary_period` number - `subtotal_summary_ytd` number - `total_contribution_refunds_col_total_period` number - `total_contribution_refunds_period` number - `total_contribution_refunds_ytd` number - `total_contributions_column_total_period` number - `total_contributions_period` number - `total_contributions_ytd` number - `total_disbursements_period` number - `total_disbursements_ytd` number - `total_fed_disbursements_period` number - `total_fed_disbursements_ytd` number - `total_fed_election_activity_period` number - `total_fed_election_activity_ytd` number - `total_fed_operating_expenditures_period` number - `total_fed_operating_expenditures_ytd` number - `total_fed_receipts_period` number - `total_fed_receipts_ytd` number - `total_individual_contributions_period` number, nullable: Individual contributions total for the reporting period - `total_individual_contributions_ytd` number, nullable: Individual contributions total for the year to date - `total_loan_repayments_made_period` number - `total_loan_repayments_made_ytd` number - `total_loans_received_period` number - `total_loans_received_ytd` number - `total_nonfed_transfers_period` number - `total_nonfed_transfers_ytd` number - `total_offsets_to_operating_expenditures_period` number - `total_offsets_to_operating_expenditures_ytd` number - `total_operating_expenditures_period` number - `total_operating_expenditures_ytd` number - `total_period` number - `total_receipts_period` number - `total_receipts_ytd` number, nullable: Anything of value (money, goods, services or property) received by a political committee total for the year to date - `total_ytd` number - `transfers_from_affiliated_committee_period` number - `transfers_from_affiliated_committee_ytd` number - `transfers_from_affiliated_party_period` number - `transfers_from_affiliated_party_ytd` number - `transfers_from_nonfed_account_period` number - `transfers_from_nonfed_account_ytd` number - `transfers_from_nonfed_levin_period` number - `transfers_from_nonfed_levin_ytd` number - `transfers_from_other_authorized_committee_period` number - `transfers_from_other_authorized_committee_ytd` number - `transfers_to_affiliated_committee_period` number - `transfers_to_affilitated_committees_ytd` number - `transfers_to_other_authorized_committee_period` number - `transfers_to_other_authorized_committee_ytd` number --- [API](https://skmtc.dev/fec/apis/openfec.md) - [All operations](https://skmtc.dev/fec/apis/openfec/llms.txt) - [OpenAPI document](https://skmtc.dev/fec/apis/openfec/revisions/d2eb3171e225?raw)