OpenFEC
This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns. The Federal Election Commission…
Government & public#openapi#open-data
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns.
The Federal Election Commission (FEC) API is a RESTful web service supporting full-text and field-specific searches on FEC data. Bulk downloads are available on the current site. Information is tied to the underlying forms by file ID and image ID. Data is updated nightly.
There are a lot of data, and a good place to start is to use search to find interesting candidates and committees. Then, you can use their IDs to find report or line item details with the other endpoints. If you are interested in individual donors, check out contributor information in the /schedule_a/ endpoints.
Getting started with the openFEC API
If you would like to use the FEC's API programmatically, you can sign up for your own API key using our form. Alternatively, you can still try out our API without an API key by using the web interface and using DEMO_KEY. Note that when you use the openFEC API you are subject to the Terms of Service and Acceptable Use policy.
Signing up for an API key will enable you to place up to 1,000 calls an hour. Each call is limited to 100 results per page. You can email questions, comments or a request to get a key for 7,200 calls an hour (120 calls per minute) to APIinfo@fec.gov . You can also ask questions and discuss the data in a community led group.
The model definitions and schema are available at /swagger. This is useful for making wrappers and exploring the data.
A few restrictions limit the way you can use FEC data. For example, you can’t use contributor lists for commercial purposes or to solicit donations. Learn more here.
Inspect our source code. We welcome issues and pull requests!
Sign up for an API key Loading signup form...
Endpoints 91
candidate
- GETGET /candidate/{candidate_id}/
/candidate/:candidate_id/?office=&candidate_status=&cycle=0&sort_nulls_last=false&state=string&district=string&year=string&name=string&sort_hide_null=false&federal_funds_flag=true&per_page=20&page=1&sort=name&has_raised_funds=true&election_year=0&api_key=DEMO_KEY&sort_null_only=false&incumbent_challenge=&party=stringThis endpoint is useful for finding detailed information about a particular candidate. Use the candidate_id to find the most recent information about that… - GETGET /candidate/{candidate_id}/history/
/candidate/:candidate_id/history/?api_key=DEMO_KEY&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=-two_year_period&election_full=true&page=1Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to… - GETGET /candidate/{candidate_id}/history/{cycle}/
/candidate/:candidate_id/history/:cycle/?api_key=DEMO_KEY&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=-two_year_period&election_full=true&page=1Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to… - GETGET /candidate/{candidate_id}/totals/
/candidate/:candidate_id/totals/?sort_nulls_last=false&cycle=0&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-cycleThis endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to… - GETGET /candidates/
/candidates/?office=&candidate_status=&cycle=0&district=string&sort_nulls_last=false&sort_hide_null=false&year=string&state=string&name=string&is_active_candidate=true&q=string&federal_funds_flag=true&per_page=20&candidate_id=string&min_first_file_date=2024-01-01&page=1&sort=name&has_raised_funds=true&election_year=0&api_key=DEMO_KEY&incumbent_challenge=&sort_null_only=false&max_first_file_date=2024-01-01&party=stringFetch basic information about candidates, and use parameters to filter results to the candidates you're looking for. Each result reflects a unique FEC… - GETGET /candidates/search/
/candidates/search/?office=&candidate_status=&cycle=0&district=string&sort_nulls_last=false&sort_hide_null=false&year=string&state=string&name=string&is_active_candidate=true&q=string&federal_funds_flag=true&per_page=20&candidate_id=string&min_first_file_date=2024-01-01&page=1&sort=name&has_raised_funds=true&election_year=0&api_key=DEMO_KEY&incumbent_challenge=&sort_null_only=false&max_first_file_date=2024-01-01&party=stringFetch basic information about candidates and their principal committees. Each result reflects a unique FEC candidate ID. That ID is assigned to the candidate… - GETGET /candidates/totals/
/candidates/totals/?office=&min_receipts=string&cycle=0&district=string&max_receipts=string&sort_hide_null=false&state=string&max_debts_owed_by_committee=string&sort_nulls_last=false&min_debts_owed_by_committee=string&is_active_candidate=true&q=string&federal_funds_flag=true&per_page=20&max_cash_on_hand_end_period=string&max_disbursements=string&candidate_id=string&page=1&has_raised_funds=true&election_full=true&election_year=0&api_key=DEMO_KEY&sort_null_only=false&min_cash_on_hand_end_period=string&sort=&party=string&min_disbursements=stringAggregated candidate receipts and disbursements grouped by cycle. - GETGET /candidates/totals/aggregates/
/candidates/totals/aggregates/?office=&sort_nulls_last=false&district=string&state=string&min_election_cycle=0&sort_hide_null=false&is_active_candidate=true&per_page=20&max_election_cycle=0&aggregate_by=office&page=1&election_year=0&election_full=true&api_key=DEMO_KEY&sort_null_only=false&sort=-election_year&party=Candidate total receipts and disbursements aggregated by aggregate_by. - GETGET /candidates/totals/by_office/
/candidates/totals/by_office/?office=&sort_nulls_last=false&page=1&min_election_cycle=0&sort_hide_null=false&election_year=0&election_full=true&api_key=DEMO_KEY&is_active_candidate=true&sort_null_only=false&per_page=20&max_election_cycle=0&sort=Aggregated candidate receipts and disbursements grouped by office by cycle. - GETGET /candidates/totals/by_office/by_party/
/candidates/totals/by_office/by_party/?office=&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&election_full=true&api_key=DEMO_KEY&is_active_candidate=true&sort_null_only=false&per_page=20&sort=Aggregated candidate receipts and disbursements grouped by office by party by cycle. - GETGET /committee/{committee_id}/candidates/
/committee/:committee_id/candidates/?office=&candidate_status=&cycle=0&sort_nulls_last=false&state=string&district=string&year=string&name=string&sort_hide_null=false&federal_funds_flag=true&per_page=20&page=1&sort=name&has_raised_funds=true&election_year=0&api_key=DEMO_KEY&sort_null_only=false&incumbent_challenge=&party=stringThis endpoint is useful for finding detailed information about a particular candidate. Use the candidate_id to find the most recent information about that… - GETGET /committee/{committee_id}/candidates/history/
/committee/:committee_id/candidates/history/?api_key=DEMO_KEY&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=-two_year_period&election_full=true&page=1Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to… - GETGET /committee/{committee_id}/candidates/history/{cycle}/
/committee/:committee_id/candidates/history/:cycle/?api_key=DEMO_KEY&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=-two_year_period&election_full=true&page=1Find out a candidate's characteristics over time. This is particularly useful if the candidate runs for the same office in different districts or you want to…
committee
- GETGET /candidate/{candidate_id}/committees/
/candidate/:candidate_id/committees/?designation=&committee_type=&page=1&filing_frequency=&cycle=0&sort_hide_null=false&year=0&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&organization_type=&sort=nameThis endpoint is useful for finding detailed information about a particular committee or filer. Use the committee_id to find the most recent information about… - GETGET /candidate/{candidate_id}/committees/history/
/candidate/:candidate_id/committees/history/?designation=&sort_nulls_last=false&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-cycleExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type. - GETGET /candidate/{candidate_id}/committees/history/{cycle}/
/candidate/:candidate_id/committees/history/:cycle/?designation=&sort_nulls_last=false&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-cycleExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type. - GETGET /committee/{committee_id}/
/committee/:committee_id/?designation=&committee_type=&page=1&filing_frequency=&cycle=0&sort_hide_null=false&year=0&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&organization_type=&sort=nameThis endpoint is useful for finding detailed information about a particular committee or filer. Use the committee_id to find the most recent information about… - GETGET /committee/{committee_id}/history/
/committee/:committee_id/history/?designation=&sort_nulls_last=false&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-cycleExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type. - GETGET /committee/{committee_id}/history/{cycle}/
/committee/:committee_id/history/:cycle/?designation=&sort_nulls_last=false&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-cycleExplore a filer's characteristics over time. This can be particularly useful if the committees change treasurers, designation, or committee_type. - GETGET /committees/
/committees/?designation=&max_first_f1_date=2024-01-01&min_first_f1_date=2024-01-01&cycle=0&filing_frequency=&sort_nulls_last=false&sort_hide_null=false&year=0&state=string&sponsor_candidate_id=string&q=string&per_page=20&min_last_f1_date=2024-01-01&candidate_id=string&committee_type=&min_first_file_date=2024-01-01&page=1&sort=name&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&max_last_f1_date=2024-01-01&treasurer_name=string&organization_type=&max_first_file_date=2024-01-01&party=stringFetch basic information about committees and filers. Use parameters to filter for particular characteristics.
dates
- GETGET /calendar-dates/
/calendar-dates/?sort_nulls_last=false&page=1&min_start_date=2024-01-01&calendar_category_id=0&sort_hide_null=false&api_key=DEMO_KEY&min_end_date=2024-01-01&event_id=0&sort_null_only=false&per_page=20&description=string&sort=-start_date&max_end_date=2024-01-01&summary=string&max_start_date=2024-01-01Combines the election and reporting dates with Commission meetings, conferences, outreach, Advisory Opinions, rules, litigation dates and other events into… - GETGET /calendar-dates/export/
/calendar-dates/export/?renderer=ics&sort_nulls_last=false&page=1&min_start_date=2024-01-01&calendar_category_id=0&sort_hide_null=false&api_key=DEMO_KEY&min_end_date=2024-01-01&event_id=0&sort_null_only=false&per_page=20&description=string&sort=-start_date&max_end_date=2024-01-01&summary=string&max_start_date=2024-01-01Returns CSV or ICS for downloading directly into calendar applications like Google, Outlook or other applications. Combines the election and reporting dates… - GETGET /election-dates/
/election-dates/?max_update_date=2024-01-01&sort_nulls_last=false&sort_hide_null=false&max_primary_general_date=2024-01-01&min_update_date=2024-01-01&max_create_date=2024-01-01&per_page=20&min_election_date=2024-01-01&election_party=string&election_type_id=string&page=1&min_create_date=2024-01-01&min_primary_general_date=2024-01-01&election_year=string&api_key=DEMO_KEY&election_district=string&office_sought=H&sort_null_only=false&max_election_date=2024-01-01&sort=-election_date&election_state=stringFEC election dates since 1995. - GETGET /reporting-dates/
/reporting-dates/?max_update_date=2024-01-01&page=1&max_due_date=2024-01-01&min_create_date=2024-01-01&min_due_date=2024-01-01&sort_hide_null=false&sort_nulls_last=false&api_key=DEMO_KEY&min_update_date=2024-01-01&max_create_date=2024-01-01&per_page=20&sort_null_only=false&sort=-due_date&report_year=0&report_type=stringFEC election dates since 1995.
financial
- GETGET /committee/{committee_id}/reports/
/committee/:committee_id/reports/?min_debts_owed_amount=string&max_disbursements_amount=string&max_total_contributions=string&max_debts_owed_expenditures=string&cycle=0&sort_nulls_last=false&sort_hide_null=false&year=0&max_receipts_amount=string&max_cash_on_hand_end_period_amount=string&is_amended=true&min_disbursements_amount=string&max_party_coordinated_expenditures=string&per_page=20&max_independent_expenditures=string&min_receipts_amount=string&min_party_coordinated_expenditures=string&candidate_id=string&beginning_image_number=string&page=1&type=string&sort=-coverage_end_date&min_total_contributions=string&api_key=DEMO_KEY&min_cash_on_hand_end_period_amount=string&sort_null_only=false&min_independent_expenditures=string&report_type=stringEach 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… - GETGET /committee/{committee_id}/totals/
/committee/:committee_id/totals/?cycle=0&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=-cycle&api_key=DEMO_KEY&page=1This endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to… - GETGET /elections/
/elections/?office=house&page=1&district=string&state=string&cycle=0&sort_hide_null=false&election_full=true&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-total_receiptsLook at the top-level financial information for all candidates running for the same office. Choose a 2-year cycle, and house, senate or presidential. If you… - GETGET /elections/search/
/elections/search/?office=house&cycle=0&district=string&zip=0&state=string&sort_hide_null=false&sort_nulls_last=false&page=1&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=sort_order,districtList elections by cycle, office, state, and district. - GETGET /elections/summary/
/elections/summary/?office=house&cycle=0&district=string&state=string&api_key=DEMO_KEY&election_full=trueList elections by cycle, office, state, and district. - GETGET /reports/{entity_type}/
/reports/:entity_type/?min_debts_owed_amount=string&max_debts_owed_expenditures=string&sort_hide_null=false&year=0&max_cash_on_hand_end_period_amount=string&filer_type=e-file&max_party_coordinated_expenditures=string&q_spender=string&max_receipt_date=2024-01-01&per_page=20&max_independent_expenditures=string&min_party_coordinated_expenditures=string&committee_type=string&page=1&min_total_contributions=string&api_key=DEMO_KEY&min_cash_on_hand_end_period_amount=string&min_receipt_date=2024-01-01&sort_null_only=false&min_independent_expenditures=string&q_filer=string&max_disbursements_amount=string&max_total_contributions=string&cycle=0&amendment_indicator=&sort_nulls_last=false&max_receipts_amount=string&is_amended=true&min_disbursements_amount=string&min_receipts_amount=string&candidate_id=string&beginning_image_number=string&sort=-coverage_end_date&committee_id=string&report_type=string&most_recent=trueEach 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… - GETGET /totals/by_entity/
/totals/by_entity/?cycle=0&sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=end_date&api_key=DEMO_KEY&page=1Provides cumulative receipt totals by entity type, over a two year cycle. Totals are adjusted to avoid double counting. This is the sql that creates these… - GETGET /totals/{entity_type}/
/totals/:entity_type/?max_first_f1_date=2024-01-01&min_receipts=string&cycle=0&filing_frequency=&max_receipts=string&sort_hide_null=false&sort_nulls_last=false&min_last_debts_owed_by_committee=string&max_last_cash_on_hand_end_period=string&treasurer_name=string&sponsor_candidate_id=string&per_page=20&max_disbursements=string&committee_state=string&committee_type=string&page=1&max_last_debts_owed_by_committee=string&committee_id=string&api_key=DEMO_KEY&committee_designation=string&sort_null_only=false&min_first_f1_date=2024-01-01&organization_type=&sort=-cycle&min_disbursements=string&min_last_cash_on_hand_end_period=stringThis endpoint provides information about a committee's Form 3, Form 3X, or Form 3P financial reports, which are aggregated by two-year period. We refer to…
search
- GETGET /names/candidates/
/names/candidates/?api_key=DEMO_KEY&q=stringSearch for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the candidate_id or… - GETGET /names/committees/
/names/committees/?api_key=DEMO_KEY&q=stringSearch for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the candidate_id or…
filings
- GETGET /candidate/{candidate_id}/filings/
/candidate/:candidate_id/filings/?office=&file_number=0&form_category=string&cycle=0&district=string&document_type=string&sort_hide_null=false&state=string&amendment_indicator=&sort_nulls_last=false&is_amended=true&filer_type=e-file&max_receipt_date=2024-01-01&per_page=20&primary_general_indicator=string&request_type=string&report_year=0&form_type=string&committee_type=string&beginning_image_number=string&page=1&sort=-receipt_date&api_key=DEMO_KEY&min_receipt_date=2024-01-01&sort_null_only=false&q_filer=string&report_type=string&party=string&most_recent=trueAll 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… - GETGET /committee/{committee_id}/filings/
/committee/:committee_id/filings/?office=&file_number=0&form_category=string&cycle=0&district=string&document_type=string&sort_hide_null=false&state=string&amendment_indicator=&sort_nulls_last=false&is_amended=true&filer_type=e-file&max_receipt_date=2024-01-01&per_page=20&primary_general_indicator=string&request_type=string&report_year=0&form_type=string&committee_type=string&beginning_image_number=string&page=1&sort=-receipt_date&api_key=DEMO_KEY&min_receipt_date=2024-01-01&sort_null_only=false&q_filer=string&report_type=string&party=string&most_recent=trueAll 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… - GETGET /filings/
/filings/?office=&file_number=0&form_category=string&cycle=0&district=string&document_type=string&sort_hide_null=false&state=string&amendment_indicator=&sort_nulls_last=false&is_amended=true&filer_type=e-file&max_receipt_date=2024-01-01&per_page=20&primary_general_indicator=string&request_type=string&report_year=0&form_type=string&candidate_id=string&committee_type=string&beginning_image_number=string&page=1&sort=-receipt_date&committee_id=string&api_key=DEMO_KEY&min_receipt_date=2024-01-01&sort_null_only=false&q_filer=string&report_type=string&party=string&most_recent=trueAll 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… - GETGET /operations-log/
/operations-log/?max_coverage_end_date=2024-01-01&sort_nulls_last=false&amendment_indicator=string&sort_hide_null=false&max_receipt_date=2024-01-01&per_page=20&min_transaction_data_complete_date=2024-01-01&form_type=string&max_transaction_data_complete_date=2024-01-01&beginning_image_number=string&page=1&min_coverage_end_date=2024-01-01&sort=-report_year&api_key=DEMO_KEY&min_receipt_date=2024-01-01&sort_null_only=false&candidate_committee_id=string&report_type=string&report_year=0&status_num=0The Operations log contains details of each report loaded into the database. It is primarily used as status check to determine when all of the data processes,…
receipts
- GETGET /schedules/schedule_a/
/schedules/schedule_a/?max_load_date=2024-01-01&max_amount=string&max_image_number=string&contributor_occupation=string&recipient_committee_designation=&sort_hide_null=false&is_individual=&line_number=string&contributor_type=individual&recipient_committee_type=&per_page=20&contributor_zip=string&contributor_city=string&last_index=&last_contribution_receipt_amount=&contributor_id=string&recipient_committee_org_type=&contributor_state=string&sort=-contribution_receipt_date&two_year_transaction_period=0&min_date=2024-01-01&committee_id=string&contributor_employer=string&min_load_date=2024-01-01&api_key=DEMO_KEY&last_contribution_receipt_date=&min_image_number=string&contributor_name=string&sort_null_only=false&image_number=string&min_amount=string&max_date=2024-01-01This description is for both /schedules/schedule_a/ and /schedules/schedule_a/{sub_id}/. This endpoint provides itemized receipts. Schedule A records… - GETGET /schedules/schedule_a/by_employer/
/schedules/schedule_a/by_employer/?employer=string&page=1&sort_nulls_last=false&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s employer name. If you are interested in our… - GETGET /schedules/schedule_a/by_occupation/
/schedules/schedule_a/by_occupation/?occupation=string&page=1&sort_nulls_last=false&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s occupation. If you are interested in our… - GETGET /schedules/schedule_a/by_size/
/schedules/schedule_a/by_size/?sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&size=0&sort_null_only=false&per_page=20&sort=This endpoint provides individual contributions received by a committee, aggregated by size: $200 and under $200.01 - $499.99 $500 - $999.99 $1000 - $1999.99… - GETGET /schedules/schedule_a/by_size/by_candidate/
/schedules/schedule_a/by_size/by_candidate/?candidate_id=string&sort_nulls_last=false&cycle=0&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=This endpoint provides itemized individual contributions received by a committee, aggregated by size of contribution and candidate. If you are interested in… - GETGET /schedules/schedule_a/by_state/
/schedules/schedule_a/by_state/?hide_null=false&page=1&cycle=0&state=string&sort_hide_null=false&sort_nulls_last=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-totalThis endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s state. If you are interested in our… - GETGET /schedules/schedule_a/by_state/by_candidate/
/schedules/schedule_a/by_state/by_candidate/?candidate_id=string&sort_nulls_last=false&cycle=0&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=This endpoint provides itemized individual contributions received by a committee, aggregated by contributor’s state and candidate. If you are interested in… - GETGET /schedules/schedule_a/by_state/by_candidate/totals/
/schedules/schedule_a/by_state/by_candidate/totals/?candidate_id=string&sort_nulls_last=false&cycle=0&page=1&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Itemized individual contributions aggregated by contributor’s state, candidate, committee type and cycle. If you are interested in our “is_individual”… - GETGET /schedules/schedule_a/by_state/totals/
/schedules/schedule_a/by_state/totals/?committee_type=string&cycle=0&page=1&state=string&sort_hide_null=false&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=cycleThis endpoint provides itemized individual contributions received by a committee, aggregated by contributor’s state, committee type and cycle. If you are… - GETGET /schedules/schedule_a/by_zip/
/schedules/schedule_a/by_zip/?page=1&cycle=0&zip=string&sort_hide_null=false&state=string&committee_id=string&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=This endpoint provides itemized individual contributions received by a committee, aggregated by the contributor’s ZIP code. If you are interested in our… - GETGET /schedules/schedule_a/efile/
/schedules/schedule_a/efile/?max_amount=string&contributor_occupation=string&max_image_number=string&sort_nulls_last=false&sort_hide_null=false&line_number=string&per_page=20&contributor_city=string&contributor_state=string&page=1&sort=-contribution_receipt_date&committee_id=string&min_date=2024-01-01&contributor_employer=string&api_key=DEMO_KEY&contributor_name=string&min_image_number=string&sort_null_only=false&image_number=string&min_amount=string&max_date=2024-01-01Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data… - GETGET /schedules/schedule_a/{sub_id}/
/schedules/schedule_a/:sub_id/?max_load_date=2024-01-01&max_amount=string&max_image_number=string&contributor_occupation=string&recipient_committee_designation=&sort_hide_null=false&is_individual=&line_number=string&contributor_type=individual&recipient_committee_type=&per_page=20&contributor_zip=string&contributor_city=string&last_index=&last_contribution_receipt_amount=&contributor_id=string&recipient_committee_org_type=&contributor_state=string&sort=-contribution_receipt_date&two_year_transaction_period=0&min_date=2024-01-01&committee_id=string&contributor_employer=string&min_load_date=2024-01-01&api_key=DEMO_KEY&last_contribution_receipt_date=&min_image_number=string&contributor_name=string&sort_null_only=false&image_number=string&min_amount=string&max_date=2024-01-01This description is for both /schedules/schedule_a/ and /schedules/schedule_a/{sub_id}/. This endpoint provides itemized receipts. Schedule A records…
disbursements
- GETGET /schedules/schedule_b/
/schedules/schedule_b/?disbursement_description=string&max_amount=string&max_image_number=string&image_number=string&sort_hide_null=false&last_disbursement_date=&line_number=string&spender_committee_designation=&last_disbursement_amount=&per_page=20&last_index=&spender_committee_type=&sort=-disbursement_date&two_year_transaction_period=0&min_date=2024-01-01&committee_id=string&api_key=DEMO_KEY&disbursement_purpose_category=string&recipient_name=string&recipient_state=string&recipient_city=string&min_image_number=string&spender_committee_org_type=&sort_null_only=false&recipient_committee_id=string&min_amount=string&max_date=2024-01-01Schedule B filings describe itemized disbursements. This data explains how committees and other filers spend their money. These figures are reported as part… - GETGET /schedules/schedule_b/by_purpose/
/schedules/schedule_b/by_purpose/?purpose=string&sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Schedule B disbursements aggregated by disbursement purpose category. To avoid double counting, memoed items are not included. Purpose is a combination of… - GETGET /schedules/schedule_b/by_recipient/
/schedules/schedule_b/by_recipient/?sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&recipient_name=string&sort_null_only=false&per_page=20&sort=Schedule B disbursements aggregated by recipient name. To avoid double counting, memoed items are not included. - GETGET /schedules/schedule_b/by_recipient_id/
/schedules/schedule_b/by_recipient_id/?sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&recipient_id=string&sort=Schedule B disbursements aggregated by recipient committee ID, if applicable. To avoid double counting, memoed items are not included. - GETGET /schedules/schedule_b/efile/
/schedules/schedule_b/efile/?disbursement_description=string&max_amount=string&page=1&sort_nulls_last=false&sort=-disbursement_date&sort_hide_null=false&committee_id=string&min_date=&api_key=DEMO_KEY&recipient_state=string&recipient_city=string&sort_null_only=false&per_page=20&image_number=string&min_amount=string&max_date=Efiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data… - GETGET /schedules/schedule_b/{sub_id}/
/schedules/schedule_b/:sub_id/?disbursement_description=string&max_amount=string&max_image_number=string&image_number=string&sort_hide_null=false&last_disbursement_date=&line_number=string&spender_committee_designation=&last_disbursement_amount=&per_page=20&last_index=&spender_committee_type=&sort=-disbursement_date&two_year_transaction_period=0&min_date=2024-01-01&committee_id=string&api_key=DEMO_KEY&disbursement_purpose_category=string&recipient_name=string&recipient_state=string&recipient_city=string&min_image_number=string&spender_committee_org_type=&sort_null_only=false&recipient_committee_id=string&min_amount=string&max_date=2024-01-01Schedule B filings describe itemized disbursements. This data explains how committees and other filers spend their money. These figures are reported as part…
loans
- GETGET /schedules/schedule_c/
/schedules/schedule_c/?min_incurred_date=&candidate_name=string&max_amount=string&max_image_number=string&sort_nulls_last=true&sort_hide_null=false&line_number=string&max_incurred_date=&per_page=20&last_index=&loan_source_name=string&page=1&sort=-incurred_date&max_payment_to_date=0&min_payment_to_date=0&committee_id=string&api_key=DEMO_KEY&min_image_number=string&sort_null_only=false&image_number=string&min_amount=stringSchedule C shows all loans, endorsements and loan guarantees a committee receives or makes. The committee continues to report the loan until it is repaid. - GETGET /schedules/schedule_c/{sub_id}/
/schedules/schedule_c/:sub_id/?sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=&api_key=DEMO_KEY&page=1Schedule C shows all loans, endorsements and loan guarantees a committee receives or makes. The committee continues to report the loan until it is repaid.
debts
- GETGET /schedules/schedule_d/
/schedules/schedule_d/?creditor_debtor_name=string&max_image_number=string&sort_nulls_last=false&max_amount_outstanding_beginning=0.0&sort_hide_null=false&min_payment_period=0.0&max_amount_incurred=0.0&nature_of_debt=string&per_page=20&max_amount_outstanding_close=0.0&candidate_id=string&page=1&min_date=2024-01-01&committee_id=string&min_amount_outstanding_close=0.0&api_key=DEMO_KEY&max_payment_period=0.0&min_image_number=string&min_amount_incurred=0.0&sort_null_only=false&image_number=string&sort=load_date&min_amount_outstanding_beginning=0.0&max_date=2024-01-01Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed. - GETGET /schedules/schedule_d/{sub_id}/
/schedules/schedule_d/:sub_id/?sort_nulls_last=false&per_page=20&sort_null_only=false&sort_hide_null=false&sort=load_date&api_key=DEMO_KEY&page=1Schedule D, it shows debts and obligations owed to or by the committee that are required to be disclosed.
independent expenditures
- GETGET /schedules/schedule_e/
/schedules/schedule_e/?max_dissemination_date=2024-01-01&sort_hide_null=false&payee_name=string&q_spender=string&per_page=20&last_index=&min_dissemination_date=2024-01-01&candidate_office_state=string&api_key=DEMO_KEY&filing_form=string&sort_null_only=false&max_amount=string&max_image_number=string&min_filing_date=2024-01-01&cycle=0&sort_nulls_last=false&support_oppose_indicator=S&candidate_office=&is_notice=true&line_number=string&last_expenditure_amount=&last_expenditure_date=&candidate_id=string&last_office_total_ytd=&last_support_oppose_indicator=&min_date=2024-01-01&candidate_party=string&committee_id=string&min_image_number=string&max_filing_date=2024-01-01&candidate_office_district=string&min_amount=string&image_number=string&sort=-expenditure_date&max_date=2024-01-01&most_recent=trueSchedule E covers the line item expenditures for independent expenditures. For example, if a super PAC bought ads on TV to oppose a federal candidate, each ad… - GETGET /schedules/schedule_e/by_candidate/
/schedules/schedule_e/by_candidate/?office=house&candidate_id=string&cycle=0&district=string&state=string&page=1&support_oppose=&election_full=true&committee_id=string&sort_hide_null=false&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Schedule E receipts aggregated by recipient candidate. To avoid double counting, memoed items are not included. - GETGET /schedules/schedule_e/efile/
/schedules/schedule_e/efile/?spender_name=string&min_expenditure_date=2024-01-01&sort_nulls_last=false&max_dissemination_date=2024-01-01&support_oppose_indicator=S&sort_hide_null=false&candidate_office=&is_notice=true&payee_name=string&per_page=20&candidate_search=string&max_expenditure_amount=0&min_dissemination_date=2024-01-01&min_filed_date=2024-01-01&candidate_id=string&candidate_office_state=string&max_filed_date=2024-01-01&page=1&min_expenditure_amount=0&committee_id=string&candidate_party=string&api_key=DEMO_KEY&max_expenditure_date=2024-01-01&filing_form=string&sort_null_only=false&candidate_office_district=string&image_number=string&sort=-expenditure_date&most_recent=trueEfiling endpoints provide real-time campaign finance data received from electronic filers. Efiling endpoints only contain the most recent four months of data… - GETGET /schedules/schedule_e/totals/by_candidate/
/schedules/schedule_e/totals/by_candidate/?candidate_id=string&sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Total independent expenditure on supported or opposed candidates by cycle or candidate election year.
party-coordinated expenditures
- GETGET /schedules/schedule_f/
/schedules/schedule_f/?max_amount=string&max_image_number=string&cycle=0&sort_nulls_last=false&sort_hide_null=false&line_number=string&payee_name=string&per_page=20&candidate_id=string&page=1&min_date=2024-01-01&committee_id=string&api_key=DEMO_KEY&min_amount=string&min_image_number=string&sort_null_only=false&image_number=string&sort=expenditure_date&max_date=2024-01-01Schedule F, it shows all special expenditures a national or state party committee makes in connection with the general election campaigns of federal… - GETGET /schedules/schedule_f/{sub_id}/
/schedules/schedule_f/:sub_id/?per_page=20&api_key=DEMO_KEY&page=1Schedule F, it shows all special expenditures a national or state party committee makes in connection with the general election campaigns of federal…
communication cost
- GETGET /communication_costs/
/communication_costs/?max_amount=string&max_image_number=string&sort_nulls_last=false&support_oppose_indicator=S&sort_hide_null=false&line_number=string&per_page=20&candidate_id=string&page=1&min_date=2024-01-01&committee_id=string&api_key=DEMO_KEY&min_amount=string&min_image_number=string&sort_null_only=false&image_number=string&sort=&max_date=2024-01-0152 U.S.C. 30118 allows "communications by a corporation to its stockholders and executive or administrative personnel and their families or by a labor… - GETGET /communication_costs/aggregates/
/communication_costs/aggregates/?candidate_id=string&page=1&cycle=0&support_oppose_indicator=&sort_hide_null=false&sort_nulls_last=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Communication cost aggregated by candidate ID and committee ID. - GETGET /communication_costs/by_candidate/
/communication_costs/by_candidate/?office=house&candidate_id=string&cycle=0&district=string&state=string&page=1&support_oppose=&election_full=true&sort_hide_null=false&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Communication cost aggregated by candidate ID and committee ID. - GETGET /communication_costs/totals/by_candidate/
/communication_costs/totals/by_candidate/?candidate_id=string&sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Total communications costs aggregated across committees on supported or opposed candidates by cycle or candidate election year.
electioneering
- GETGET /electioneering/
/electioneering/?candidate_id=string&max_amount=string&sort_nulls_last=false&page=1&sort_hide_null=false&committee_id=string&min_date=2024-01-01&api_key=DEMO_KEY&min_amount=string&per_page=20&sort_null_only=false&description=string&sort=&report_year=0&last_index=&max_date=2024-01-01An electioneering communication is any broadcast, cable or satellite communication that fulfills each of the following conditions: _The communication refers… - GETGET /electioneering/aggregates/
/electioneering/aggregates/?candidate_id=string&sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Electioneering communications costs aggregates - GETGET /electioneering/by_candidate/
/electioneering/by_candidate/?office=house&candidate_id=string&cycle=0&district=string&state=string&page=1&sort_hide_null=false&election_full=true&sort_nulls_last=false&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Electioneering costs aggregated by candidate - GETGET /electioneering/totals/by_candidate/
/electioneering/totals/by_candidate/?candidate_id=string&sort_nulls_last=false&page=1&cycle=0&sort_hide_null=false&election_full=true&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=Total electioneering communications spent on candidates by cycle or candidate election year
presidential
- GETGET /presidential/contributions/by_candidate/
/presidential/contributions/by_candidate/?contributor_state=string&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-net_receiptsNet receipts per candidate. Filter with contributor_state='US' for national totals - GETGET /presidential/contributions/by_size/
/presidential/contributions/by_size/?candidate_id=string&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&api_key=DEMO_KEY&size=0&sort_null_only=false&per_page=20&sort=sizeContribution receipts by size per candidate. Filter by candidate_id, election_year and/or size - GETGET /presidential/contributions/by_state/
/presidential/contributions/by_state/?candidate_id=string&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-contribution_receipt_amountContribution receipts by state per candidate. Filter by candidate_id and/or election_year - GETGET /presidential/coverage_end_date/
/presidential/coverage_end_date/?candidate_id=string&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=candidate_idCoverage end date per candidate. Filter by candidate_id and/or election_year - GETGET /presidential/financial_summary/
/presidential/financial_summary/?candidate_id=string&sort_nulls_last=false&page=1&sort_hide_null=false&election_year=0&api_key=DEMO_KEY&sort_null_only=false&per_page=20&sort=-net_receiptsFinancial summary per candidate. Filter by candidate_id and/or election_year
filer resources
- GETGET /rad-analyst/
/rad-analyst/?min_assignment_update_date=2024-01-01&max_assignment_update_date=2024-01-01&analyst_short_id=0&email=string&page=1&sort_nulls_last=false&title=string&sort_hide_null=false&committee_id=string&name=string&telephone_ext=0&api_key=DEMO_KEY&analyst_id=0&sort_null_only=false&per_page=20&sort=Use this endpoint to look up the RAD Analyst for a committee. The mission of the Reports Analysis Division (RAD) is to ensure that campaigns and political… - GETGET /state-election-office/
/state-election-office/?sort_null_only=false&sort_nulls_last=false&per_page=20&state=string&sort_hide_null=false&sort=&api_key=DEMO_KEY&page=1State laws and procedures govern elections for state or local offices as well as how candidates appear on election ballots. Contact the appropriate state…
efiling
- GETGET /efile/filings/
/efile/filings/?file_number=0&sort_nulls_last=false&page=1&per_page=20&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&min_receipt_date=2024-01-01&max_receipt_date=2024-01-01&q_filer=string&sort_null_only=false&sort=-receipt_dateBasic information about electronic files coming into the FEC, posted as they are received. - GETGET /efile/reports/house-senate/
/efile/reports/house-senate/?file_number=0&sort_nulls_last=false&page=1&per_page=20&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&min_receipt_date=2024-01-01&max_receipt_date=2024-01-01&q_filer=string&sort_null_only=false&sort=-receipt_dateKey financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the… - GETGET /efile/reports/pac-party/
/efile/reports/pac-party/?file_number=0&sort_nulls_last=false&page=1&per_page=20&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&min_receipt_date=2024-01-01&max_receipt_date=2024-01-01&q_filer=string&sort_null_only=false&sort=-receipt_dateKey financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the… - GETGET /efile/reports/presidential/
/efile/reports/presidential/?file_number=0&sort_nulls_last=false&page=1&per_page=20&sort_hide_null=false&committee_id=string&api_key=DEMO_KEY&min_receipt_date=2024-01-01&max_receipt_date=2024-01-01&q_filer=string&sort_null_only=false&sort=-receipt_dateKey financial data reported periodically by committees as they are reported. This feed includes summary information from the the House F3 reports, the…
audit
- GETGET /audit-case/
/audit-case/?audit_case_id=string&cycle=0&sub_category_id=all&sort_nulls_last=false&sort_hide_null=false&min_election_cycle=0&audit_id=0&q=string&per_page=20&max_election_cycle=0&candidate_id=string&committee_type=string&qq=string&page=1&committee_id=string&api_key=DEMO_KEY&committee_designation=string&primary_category_id=all&sort_null_only=false&sort=-cycle,committee_nameThis endpoint contains Final Audit Reports approved by the Commission since inception. The search can be based on information about the audited committee… - GETGET /audit-category/
/audit-category/?sort_nulls_last=false&page=1&primary_category_name=string&sort_hide_null=false&api_key=DEMO_KEY&primary_category_id=string&sort_null_only=false&per_page=20&sort=primary_category_nameThis lists the options for the categories and subcategories available in the /audit-search/ endpoint. - GETGET /audit-primary-category/
/audit-primary-category/?sort_nulls_last=false&page=1&primary_category_name=string&sort_hide_null=false&api_key=DEMO_KEY&primary_category_id=string&sort_null_only=false&per_page=20&sort=primary_category_nameThis lists the options for the primary categories available in the /audit-search/ endpoint. - GETGET /names/audit_candidates/
/names/audit_candidates/?api_key=DEMO_KEY&q=stringSearch for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the candidate_id or… - GETGET /names/audit_committees/
/names/audit_committees/?api_key=DEMO_KEY&q=stringSearch for candidates or committees by name. If you're looking for information on a particular person or group, using a name to find the candidate_id or…
legal
- GETGET /legal/search/
/legal/search/?hits_returned=0&af_report_year=string&case_max_open_date=2024-01-01&ao_max_issue_date=2024-01-01&case_statutory_citation=string&case_respondents=string&q=string&ao_min_issue_date=2024-01-01&af_max_fd_date=2024-01-01&from_hit=0&af_fd_fine_amount=0&type=string&api_key=DEMO_KEY&af_name=string&ao_requestor_type=1&ao_statutory_citation=string&ao_entity_name=string&mur_type=string&ao_regulatory_citation=string&af_committee_id=string&ao_requestor=string&case_citation_require_all=true&af_min_fd_date=2024-01-01&ao_is_pending=true&af_rtb_fine_amount=0&case_election_cycles=0&ao_category=F&ao_citation_require_all=true&case_dispositions=string&af_max_rtb_date=2024-01-01&case_min_open_date=2024-01-01&case_max_close_date=2024-01-01&ao_min_request_date=2024-01-01&ao_status=string&case_doc_category_id=1&af_min_rtb_date=2024-01-01&ao_name=string&case_regulatory_citation=string&ao_no=string&case_min_close_date=2024-01-01&sort=string&ao_max_request_date=2024-01-01&case_no=stringSearch legal documents by document type, or across all document types using keywords, parameter values and ranges.
API details
- Authentication
- An API key in the X-Api-Key header
An API key in the api_key query parameter
An API key in the api_key query parameter - Operations
- 91 operations on 91 pathsGET 91
- Main resources
- candidate 13receipts 12financial 8committee 7disbursements 6audit 5presidential 5communication cost 4dates 4efiling 4
- Response formats
application/json- Description format
- OpenAPI 3.0.0, API version
1.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the OpenFEC in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the OpenFEC collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-Api-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “GET /candidate/{candidate_id}/” (GET /candidate/:candidate_id/?office=&candidate_status=&cycle=0&sort_nulls_last=false&state=string&district=string&year=string&name=string&sort_hide_null=false&federal_funds_flag=true&per_page=20&page=1&sort=name&has_raised_funds=true&election_year=0&api_key=DEMO_KEY&sort_null_only=false&incumbent_challenge=&party=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the OpenFEC?
This application programming interface (API) allows you to explore the way candidates and committees fund their campaigns. The Federal Election Commission… It is listed under Government & public and has 91 endpoints.
Who publishes the OpenFEC?
It is listed from FEC.gov's public API description (an OpenAPI document), not published by FEC.gov on Swastik Codes. Anyone who controls fec.gov can claim the profile by adding a DNS TXT record.
How do I authenticate with the OpenFEC?
It accepts 3 methods: an API key in the X-Api-Key header; an API key in the api_key query parameter; an API key in the api_key query parameter.
How many endpoints does the OpenFEC have?
91 operations on 91 paths (91 GET). The largest groups are candidate, receipts, financial, committee.
Is forking the OpenFEC free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.