--- title: "GET /v1/filings/" method: GET path: "/v1/filings/" tags: ["filings"] --- # GET /v1/filings/ `GET /v1/filings/` ## 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/filings/` - 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) All official records and reports filed by or delivered to the FEC. Note: because the filings data includes many records, counts for large result sets are approximate; you will want to page through the records until no records are returned. ## Query parameters - `page` integer - `per_page` integer - `committee_type` string - `cycle` integer[] - `is_amended` boolean - `most_recent` boolean - `report_type` string[] - `request_type` string[] - `document_type` string[] - `beginning_image_number` string[] - `report_year` integer[] - `min_receipt_date` string - `max_receipt_date` string - `form_type` string[] - `state` string[] - `district` string[] - `office` string[] - `party` string[] - `filer_type` 'e-file' | 'paper' - `file_number` integer[] - `primary_general_indicator` string[] - `amendment_indicator` string[] - `form_category` string[] - `q_filer` string[] - `sort` string[] - `sort_hide_null` boolean - `sort_null_only` boolean - `sort_nulls_last` boolean - `committee_id` string[] - `candidate_id` string[] - `api_key` string ## Response `default` Default response - FilingsPage - `pagination` OffsetInfo - `count` integer - `is_count_exact` boolean - `page` integer - `pages` integer - `per_page` integer - `results` Filings[] - `additional_bank_names` string[], nullable: Additional banks or depositories in which the committee deposits funds, holds accounts, rents safety deposit boxes or maintains funds. - `amendment_chain` integer[] - `amendment_indicator` string, 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_version` integer, nullable: Amendment version - `bank_depository_city` string, nullable: City of bank or depository as reported on the Form 1 - `bank_depository_name` string, nullable: Primary bank or depository in which the committee deposits funds,holds accounts, rents safety deposit boxes or maintains funds. - `bank_depository_state` string, nullable: State of bank or depository as reported on the Form 1 - `bank_depository_street_1` string, nullable: Street of bank or depository as reported on their Form 1. - `bank_depository_street_2` string, nullable: Second line of the street of bank or depository as reported on the Form 1 - `bank_depository_zip` string, nullable: Zip code of bank or depository as reported on the Form 1 - `beginning_image_number` string - `candidate_id` 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. - `candidate_name` string, nullable: Name of candidate running for office - `cash_on_hand_beginning_period` 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, 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 - `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 - `cycle` integer, nullable: 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. - `debts_owed_by_committee` number - `debts_owed_to_committee` number - `document_description` string - `document_type` string, nullable: The type of document for documents other than reports: - 2 24 Hour Contribution Notice - 4 48 Hour Contribution Notice - A Debt Settlement Plan - B Acknowledgment of Receipt of Debt Settlement Statement - C RFAI: Debt Settlement First Notice - D Commission Debt Settlement Review - E Commission Response To Debt Settlement Request - F Administrative Termination - G Debt Settlement Plan Amendment - H Disavowal Notice - I Disavowal Response - J Conduit Report - K Termination Approval - L Repeat Non-Filer Notice - M Filing Frequency Change Notice - N Paper Amendment to Electronic Report - O Acknowledgment of Filing Frequency Change - P Notice of Paper Filing - Q Acknowledgment of F3L Filing Frequency Change - R F3L Filing Frequency Change Notice - S RFAI: Debt Settlement Second - T Miscellaneous Submission To FEC - U Unregistered Committee Notice - V Repeat Violation Notice (441A OR 441B) - W C-1/Loan Agreement - X Loan Forgiveness - `document_type_full` string, nullable: The type of document for documents other than reports: - 2 24 Hour Contribution Notice - 4 48 Hour Contribution Notice - A Debt Settlement Plan - B Acknowledgment of Receipt of Debt Settlement Statement - C RFAI: Debt Settlement First Notice - D Commission Debt Settlement Review - E Commission Response To Debt Settlement Request - F Administrative Termination - G Debt Settlement Plan Amendment - H Disavowal Notice - I Disavowal Response - J Conduit Report - K Termination Approval - L Repeat Non-Filer Notice - M Filing Frequency Change Notice - N Paper Amendment to Electronic Report - O Acknowledgment of Filing Frequency Change - P Notice of Paper Filing - Q Acknowledgment of F3L Filing Frequency Change - R F3L Filing Frequency Change Notice - S RFAI: Debt Settlement Second - T Miscellaneous Submission To FEC - U Unregistered Committee Notice - V Repeat Violation Notice (441A OR 441B) - W C-1/Loan Agreement - X Loan Forgiveness - `election_year` integer, nullable: Year of election - `ending_image_number` string - `fec_file_id` string - `fec_url` string - `file_number` integer, nullable: Filing ID number - `form_category` string, nullable: The forms filed are categorized based on the nature of the filing: - REPORT F3, F3X, F3P, F3L, F4, F5, F7, F13, F24 - NOTICE F6, F9, F10, F11 - STATEMENT F1, F2 - OTHER F1M, F8, F99, F12, FRQ - `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 - FRQ Request for Additional Information - `house_personal_funds` number - `html_url` string, nullable: HTML link to the filing. - `is_amended` boolean, nullable: False indicates that a report is the most recent. True indicates that the report has been superseded by an amendment. - `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` integer, nullable - `net_donations` number - `office` string, nullable: Federal office candidate runs for: H, S or P - `opposition_personal_funds` number - `pages` integer, nullable: Number of pages in the document - `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. - `pdf_url` string, nullable: pdf link to the filing - `previous_file_number` integer, nullable: Previous filing ID number - `primary_general_indicator` string, nullable: Primary general indicator - `receipt_date` string, date-time, nullable: Date the FEC received the electronic or paper record - `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 - `report_year` integer, nullable: Forms with coverage date - year from the coverage ending date. Forms without coverage date - year from the receipt date. - `request_type` string, nullable: Requests for additional information (RFAIs) sent to filers. The request type is based on the type of document filed: - 1 Statement of Organization - 2 Report of Receipts and Expenditures (Form 3 and 3X) - 3 Second Notice - Reports - 4 Request for Additional Information - 5 Informational - Reports - 6 Second Notice - Statement of Organization - 7 Failure to File - 8 From Public Disclosure - 9 From Multi Candidate Status - `senate_personal_funds` number - `state` string, nullable: US state or territory where a candidate runs for office - `sub_id` string - `total_communication_cost` number - `total_disbursements` number - `total_independent_expenditures` number - `total_individual_contributions` number - `total_receipts` number - `treasurer_name` string, nullable: Name of the Committee's treasurer. If multiple treasurers for the committee, the most recent treasurer will be shown. - `update_date` string, date, nullable: Date the record was updated --- [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)