--- title: "GET /v1/schedules/schedule_e/efile/" method: GET path: "/v1/schedules/schedule_e/efile/" tags: ["independent expenditures"] --- # GET /v1/schedules/schedule_e/efile/ `GET /v1/schedules/schedule_e/efile/` ## 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/schedules/schedule_e/efile/` - 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) Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data and don't contain the processed and coded data that you can find on other endpoints. ## Query parameters - `page` integer - `per_page` integer - `candidate_search` string[] - `committee_id` string[] - `candidate_id` string[] - `payee_name` string[] - `image_number` string[] - `support_oppose_indicator` string[] - `min_expenditure_date` string - `max_expenditure_date` string - `min_dissemination_date` string - `max_dissemination_date` string - `min_expenditure_amount` integer - `max_expenditure_amount` integer - `spender_name` string[] - `candidate_party` string[] - `candidate_office` '' | 'H' | 'S' | 'P' - `candidate_office_state` string[] - `candidate_office_district` string[] - `most_recent` boolean - `min_filed_date` string - `max_filed_date` string - `filing_form` string[] - `is_notice` boolean - `sort` string - `sort_hide_null` boolean - `sort_null_only` boolean - `sort_nulls_last` boolean - `api_key` string ## Response `default` Default response - ScheduleEEfilePage - `pagination` OffsetInfo - `count` integer - `is_count_exact` boolean - `page` integer - `pages` integer - `per_page` integer - `results` ScheduleEEfile[] - `amendment_indicator` string, nullable - `back_reference_schedule_name` string, nullable - `back_reference_transaction_id` string, nullable - `beginning_image_number` string - `candidate_first_name` string, nullable - `candidate_id` string, nullable - `candidate_middle_name` string, nullable - `candidate_name` string, nullable: Name of candidate running for office - `candidate_office` string, nullable: Federal office candidate runs for: H, S or P - `candidate_office_district` string, nullable: Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00. - `candidate_office_state` string, nullable: US state or territory - `candidate_party` string, nullable: Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party. - `candidate_prefix` string, nullable - `candidate_suffix` string, nullable - `category_code` string, nullable - `committee` CommitteeHistory - `affiliated_committee_name` string, nullable: Affiliated committee or connected organization - `candidate_ids` string[], nullable: 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. - `city` string, nullable: City of committee as reported on the Form 1 - `committee_id` string, required: 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_type` string, nullable: 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 - `committee_type_full` string, nullable: 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 - `cycle` integer, required: A two year election cycle that the committee was active- (after original registration date but before expiration date in Form 1s) The cycle begins with an odd year and is named for its ending, even year. - `cycles` integer[], nullable: A two year election cycle that the committee was active- (after original registration date but before expiration date in Form 1s) The cycle begins with an odd year and is named for its ending, even year. - `cycles_has_activity` integer[], nullable: A two year election cycle that the committee was active- (after original registration date but before expiration date in Form 1), and the committee has filling activity during the cycle - `cycles_has_financial` integer[], nullable: A two year election cycle that the committee was active- (after original registration date but before expiration date in Form 1s), and the committee files the financial reports ('F3', 'F3X', 'F3P', 'F3L', 'F4', 'F5', 'F7', 'F13') during this cycle. - `designated_agent_city` string, nullable: Designated agent city - `designated_agent_first_name` string, nullable: Designated agent first name - `designated_agent_last_name` string, nullable: Designated agent last name - `designated_agent_middle_name` string, nullable: Designated agent middle name - `designated_agent_name` string, nullable: Designated agent name - `designated_agent_phone_number` string, nullable: Designated agent phone number - `designated_agent_prefix` string, nullable: Designated agent prefix - `designated_agent_state` string, nullable: Designated agent state - `designated_agent_street1` string, nullable: Designated agent street1 - `designated_agent_street2` string, nullable: Designated agent street2 - `designated_agent_suffix` string, nullable: Designated agent suffix - `designated_agent_title` string, nullable: Designated agent title - `designated_agent_zip` string, nullable: Designated agent zip - `designation` string, nullable: The one-letter designation code of the organization: - A authorized by a candidate - J joint fundraising committee - P principal campaign committee of a candidate - U unauthorized - B lobbyist/registrant PAC - D leadership PAC - `designation_full` string, nullable: The one-letter designation code of the organization: - A authorized by a candidate - J joint fundraising committee - P principal campaign committee of a candidate - U unauthorized - B lobbyist/registrant PAC - D leadership PAC - `filing_frequency` string, nullable: The one-letter code of the filing frequency: - A Administratively terminated - D Debt - M Monthly filer - Q Quarterly filer - T Terminated - W Waived - `first_f1_date` string, date, nullable: The day the FEC received the committee's first Form 1 - `first_file_date` string, date, nullable: The day the FEC received the committee's first filing. This is usually a Form 1 committee registration. - `is_active` boolean, nullable: True indicates that a committee is active. - `jfc_committee` JFCCommittee[] - `joint_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. - `joint_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. - `last_cycle_has_activity` integer, nullable: The latest two year election cycle that the committee has filings - `last_cycle_has_financial` integer, nullable: The latest two year election cycle that the committee files the financial reports ('F3', 'F3X', 'F3P', 'F3L', 'F4', 'F5', 'F7', 'F13'). - `last_f1_date` string, date, nullable: The day the FEC received the committee's most recent Form 1 - `last_file_date` string, date, nullable: The day the FEC received the committee's most recent filing - `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. - `organization_type` string, nullable: The one-letter code for the kind for organization: - C corporation - L labor organization - M membership organization - T trade association - V cooperative - W corporation without capital stock - H host committee - I inaugural committee - `organization_type_full` string, nullable: The one-letter code for the kind for organization: - C corporation - L labor organization - M membership organization - T trade association - V cooperative - W corporation without capital stock - H host committee - I inaugural committee - `party` string, nullable: Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party. - `party_full` string, nullable: Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party. - `state` string, nullable: State of the committee's address as filed on the Form 1 - `state_full` string, nullable: State of committee as reported on the Form 1 - `street_1` string, nullable: Street address of committee as reported on the Form 1 - `street_2` string, nullable: Second line of street address of committee as reported on the Form 1 - `treasurer_name` string, nullable: Name of the Committee's treasurer. If multiple treasurers for the committee, the most recent treasurer will be shown. - `zip` string, nullable: Zip code of committee as reported on the Form 1 - `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. - `csv_url` string - `dissemination_date` string, date, nullable: Date when a PAC distrubutes or disseminates an independent expenditure and pays for it in the same reporting period - `entity_type` string, nullable - `expenditure_amount` integer, nullable - `expenditure_date` string, date, nullable - `expenditure_description` string, nullable - `fec_url` string - `file_number` integer, required - `filer_first_name` string, nullable - `filer_last_name` string, nullable - `filer_middle_name` string, nullable - `filer_prefix` string, nullable - `filer_suffix` string, nullable - `filing` EFilings - `amended_by` integer - `amendment_chain` integer[] - `amendment_number` integer, nullable: Number of times the report has been amended. - `amends_file` integer, nullable: For amendments, this file_number is the file_number of the previous report that is being amended. Refer to the amended_by for the most recent version of the report. - `beginning_image_number` string - `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. - `coverage_end_date` string, date, nullable: Ending date of the reporting period - `coverage_start_date` string, date, nullable: Beginning date of the reporting period - `csv_url` string - `document_description` string - `ending_image_number` string - `fec_file_id` string - `fec_url` string - `file_number` integer: Filing ID number - `filed_date` string, date, nullable: Timestamp of electronic or paper record that FEC received - `form_type` string, nullable: The form where the underlying data comes from, for example Form 1 would appear as F1: - F1 Statement of Organization - F1M Notification of Multicandidate Status - F2 Statement of Candidacy - F24 24/48 Hour Report of Independent Expenditures - F3 Report of Receipts and Disbursements for an Authorized Committee - F3P Report of Receipts and Disbursements by an Authorized Committee of a Candidate for The Office of President or Vice President - F3L Report of Contributions Bundled by Lobbyists/Registrants and Lobbyist/Registrant PACs - F3X Report of Receipts and Disbursements for other than an Authorized Committee - F4 Report of Receipts and Disbursements for a Committee or Organization Supporting a Nomination Convention - F5 Report of Independent Expenditures Made and Contributions Received - F6 48 Hour Notice of Contributions/Loans Received - F7 Report of Communication Costs by Corporations and Membership Organizations - F8 Debt Settlement Plan - F9 24 Hour Notice of Disbursements for Electioneering Communications - F13 Report of Donations Accepted for Inaugural Committee - F99 Miscellaneous Text NOTE: This filter also works if you specify new, amended, or termination, for example F3XN, F3XA, or F3XT respectively - `html_url` string - `is_amended` boolean - `load_timestamp` string, date-time, nullable: Date the information was loaded into the FEC systems. This can be affected by reseting systems and other factors, refer to receipt_date for the day that the FEC received the paper or electronic document. Keep in mind that paper filings take more time to process and there can be a lag between load_date and receipt_date. This field can be helpful to identify paper records that have been processed recently. - `most_recent` boolean - `most_recent_filing` integer - `pdf_url` string - `receipt_date` string, date-time, nullable: Date the FEC received the electronic or paper record - `filing_form` string, nullable - `image_number` string, nullable: An unique identifier for each page where the electronic or paper filing is reported. - `is_notice` boolean - `line_number` string, nullable - `load_timestamp` string, date-time, nullable - `memo_code` string, nullable - `memo_text` string, nullable - `most_recent` boolean, nullable: Report is either new or is the most-recently filed amendment - `notary_sign_date` string, date, nullable - `office_total_ytd` number, nullable - `payee_city` string, nullable - `payee_first_name` string, nullable - `payee_last_name` string, nullable - `payee_middle_name` string, nullable - `payee_name` string - `payee_prefix` string, nullable - `payee_state` string, nullable - `payee_street_1` string, nullable - `payee_street_2` string, nullable - `payee_suffix` string, nullable - `payee_zip` string, nullable - `pdf_url` string - `related_line_number` integer, required - `report_type` string - `support_oppose_indicator` string, nullable: Explains if the money was spent in order to support or oppose a candidate or candidates. (Coded S or O for support or oppose.) This indicator applies to independent expenditures and communication costs. - `transaction_id` string, nullable --- [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)