filings

GET /v1/filings/

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.

Request

  • Base URL
    https://api.open.fec.gov (the document declares no server; this is the origin it was published from)
  • 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.

Query parameters

pageinteger

For paginating through results, starting at page 1

per_pageinteger

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

committee_typestring

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

cycleinteger[]

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.

is_amendedboolean

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

most_recentboolean

Report is either new or is the most-recently filed amendment

report_typestring[]

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)

request_typestring[]

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

document_typestring[]

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

beginning_image_numberstring[]

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

report_yearinteger[]

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

min_receipt_datestring

Selects all filings received after this date(MM/DD/YYYY or YYYY-MM-DD)

max_receipt_datestring

Selects all filings received before this date(MM/DD/YYYY or YYYY-MM-DD)

form_typestring[]

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

statestring[]

US state or territory where a candidate runs for office

districtstring[]

Two-digit US House distirict of the office the candidate is running for. Presidential, Senate and House at-large candidates will have District 00.

officestring[]

Federal office candidate runs for: H, S or P

partystring[]

Three-letter code for the party affiliated with a candidate or committee. For example, DEM for Democratic Party and REP for Republican Party.

filer_type'e-file' | 'paper'

The method used to file with the FEC, either electronic or on paper.

file_numberinteger[]

Filing ID number

primary_general_indicatorstring[]

Primary, general or special election indicator.

amendment_indicatorstring[]

Amendent types: -N new -A amendment -T terminated -C consolidated -M multi-candidate -S secondary

NULL might be new or amendment. If amendment indicator is null and the filings is the first or first in a chain treat it as if it was a new. If it is not the first or first in a chain then treat the filing as an amendment.

form_categorystring[]

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

q_filerstring[]

Keyword search for filer name or ID

sortstring[]

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

sort_hide_nullboolean

Hide null values on sorted column(s).

sort_null_onlyboolean

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

sort_nulls_lastboolean

Toggle that sorts null values last

committee_idstring[]

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.

candidate_idstring[]

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.

api_keystring

Response

Default response

Changes

No recorded changes to this operation across all 20 revisions of this API.